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Avant-propos 



A qui s'adresse ce livre 

Cet ouvrage est destine a tous ceux qui souhaitent maitriser la programmation en Java. II 
s'adresse a la fois aux etudiants, aux developpeurs et aux enseignants en informatique. 

II suppose que le lecteur possede deja une experience de la programmation dans un autre lan- 
gage (Cobol, Pascal, C, C++, Visual Basic, Delphi, PHP, Perl, Python...). En revanche, la 
connaissance de la programmation orientee objet n'est nullement necessaire, pas plus que 
celle de la programmation d'interfaces graphiques ou d' applications Web. 

Contenu de I'ouvrage 

Les fondements de Java 

Les chapitres 1 a 1 1 sont consacres aux fondements du langage : types primitifs, operateurs et 
expressions, instructions, classes, heritage, tableaux et chaines de caracteres. Les aspects les 
plus fondamentaux de la programmation orientee objet que sont le polymorphisme, la surde- 
finition et la redefinition des methodes y sont egalement etudies de facon approfondie, aussi 
bien dans leur puissance que dans leurs limitations. 

Tous les aspects du langage sont couverts, y compris ceux qui sont specifiques a Java comme 
les interfaces, les classes internes, les classes anonymes, les exceptions ou les threads. Les 
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moins usites font generalement Fobjet d'un paragraphe intitule Informations comple- 
mentaires dont la connaissance n'est pas indispensable a l'etude de la suite de l'ouvrage. 

Par ailleurs, le chapitre 21 presente les possibilites de programmation generique introduites 
recemment. Sa place tardive dans l'ouvrage est surtout justifiee par son lien etroit avec les 
collections presentees au chapitre 22. 

Enfin, le chapitre 24 presente les annotations et les techniques d'introspection. 

Les principales API 

Le JDK {Java Developpement Kit) de Java est livre, en standard, avec differentes bibliothe- 
ques ou "paquetages" ou "API" {Application Programming Interface) fournissant de nom- 
breuses classes utilitaires. Les chapitres 12 a 20, 22 et 23 examinent les API qui 
correspondent aux besoins les plus universels et qui, a ce titre, peuvent etre considered 
comme partie integrante du langage. 

Les chapitres 12 a 19 sont consacres a la programmation d' interfaces graphiques en Java a 
l'aide de 1' API nommee Swing : evenements et ecouteurs ; boutons, cases a cocher et boutons 
radio ; boites de dialogue ; menus ; b aires d'outils ; actions abstraites ; evenements generes 
par le clavier, la souris, les fenetres et la focalisation ; gestionnaires de mise en forme ; affi- 
chage de textes et de dessins ; applets. Dans cette partie, 1' accent est mis sur les mecanismes 
fondamentaux qui interviennent en programmation graphique et evenementielle. 

Le chapitre 20 traite de l'API relative aux entrees-sorties, unifiees a tiavers la notion de flux. 
II integre un exemple de connexion TCP/IP par "sockets". 

Le chapitre 22 decrit les principales structures de donnees qu'on regroupe souvent sous le 
terme de collection : listes, ensembles, vecteurs dynamiques, queues et tables associatives. 

Enfin, le chapitre 23 se veut une introduction aux possibilites de programmation cote serveur 
offertes par les servlets, les JSP et les "JavaBeans". En toute rigueur, il s'agit la, non plus 
d'API standard de Java, mais de specifications de JEE {Java Enterprise Edition). 

Pour aller plus loin 

Apres l'etude de cet ouvrage consacre a ce que Ton pourrait appeler les "bases elargies du 
langage", le lecteur pourra apprehender aisement l'importante documentation des classes 
standards Java et de leurs methodes 1 . II sera alors parfaitement arme pour developper ses pro- 
pres applications, aussi complexes et specialisees soient-elles, notamment Faeces aux bases 
de donnees avec JDBC ou le developpement d' applications reparties, non traites dans cet 
ouvrage. 



1. Par exemple, en consultant le site officiel de Java : http://java.sun.com/reference/docs/. 
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Forme de I'ouvrage 

L'ouvrage est concu sous la forme d'un cours. II expose progressivement les differentes 
notions fondamentales, en les illustrant systematiquement de programmes complets accom- 
pagnes d'un exemple d' execution. 

Pour en faciliter 1' assimilation, les fondements du langage sont presentes de facon indepen- 
dante de la programmation d'interfaces graphiques, en s'appuyant sur les possibilites 
qu'offre Java d'ecrire des applications a interface console. 

Dans la partie consacree a la programmation graphique, les composants sont introduits pro- 
gressivement pour permettre au lecteur de les decouvrir en tant qu'utilisateur de logiciel. 
L' experience montre en effet, que, pour realiser une bonne interface graphique, un deve- 
loppeur doit non seulement savoir programmer correctement les composants concernes, mais 
egalement bien connaitre leur ergonomie. 

Outre son caractere didactique, nous avons concu l'ouvrage d'une maniere tres structuree 
pour qu'il puisse etre facilement consulte au-dela de la phase d'apprentissage du langage. 
Dans cet esprit, il est dote d'une table des matieres detaillee et d'un index fourni dans lequel 
les noms de methodes sont toujours accompagnes du nom de la classe correspondante (il peut 
y avoir plusieurs classes). Les exemples complets peuvent servir a une rememoration rapide 
du concept qu'ils illustrent. Des encadres permettent de retrouver rapidement la syntaxe 
d'une instruction, ainsi que les regies les plus importantes. Enfin, des annexes fournissent des 
aide-memoire faciles a consulter : 

• liste des fonctions mathematiques (classe Math) ; 

• liste des exceptions standards ; 

• liste des composants et des en-tetes de leurs methodes ; 

• liste des evenements, ecouteurs et methodes correspondantes ; 

• liste des classes et interfaces liees aux collections et methodes correspondantes, 

• outils de professionnalisation des applications (pour la plupart introduits par Java 6). 

L'ouvrage, les versions de Java et C++ 

Si les instructions de base de Java n'ont pratiquement pas evolue depuis sa naissance jusqu'a 
sa version 5, il n'en va pas de meme de ses bibliotheques standards. En particulier, le modele 
de gestion des evenements a ete fortement modifie par la version 1.1. Une nouvelle bibliothe- 
que de composants graphiques, Swing, est apparue dans la version 1.2 de F edition Standard 
de Java, renommee a cette occasion J2SE (Java 2 Standard Edition). Apres deux nouvelles 
versions nommees respectivement J2SE 1.3 et J2SE 1.4, Sun a modifie son systeme de nume- 
rotation en introduisant J2SE 5 en 2004, puis Java SE 6 en 2006. Nous parlerons plus simple- 
ment de Java 5 et Java 6 pour nous referer a ces deux demieres. 
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Depuis J2SE 1.2, F edition standard de Java est completee par un ensemble de specifications, 
nomme J2EE (Java 2 Enterprise Edition) jusqu'a la version 4 et JEE (Java Enterprise Edition) 
depuis la version 5 ; ces specifications sont dediees notamment au developpement cote ser- 
veur et aux applications reparties 1 . 

La version standard J2SE 5 a introduit bon nombre de nouveautes fondamentales qui avaient 
deja ete integrees dans la precedente edition de l'ouvrage : types enumeres, types enveloppes, 
boxing/unboxing automatiques, arguments variables en nombre, boucle for... each. Un chapi- 
tre a ete consacre aux possibilites de programmation generique. Le chapitre relatif aux col- 
lections a ete fortement remanie pour tenir compte de leur aspect generique, mais aussi pour 
permettre l'utilisation d'anciens codes. 

Par rapport a la precedente, cette nouvelle edition prend en compte les apports de la nouvelle 
version Java 6. Notamment, nous presentons le nouveau gestionnaire de mise en forme qu'est 
GroupLayout, ainsi que les fonctionnalites permettant de professionnaliser une application 
(classe Desktop, classe Console, action sur la barre des taches du systeme). Nous tenons 
compte des nouvelles possibilites offertes par la classe File ainsi que des nouvelles interfaces 
et classes de collections (Deque, ArrayDeque, NavigableSet, NavigableMap). En outre, nous 
avons introduit un nouveau chapitre concernant les annotations (deja presentes dans Java 5, 
mais mieux integrees dans le langage depuis Java 6) et nous avons en meme temps decrit les 
possibilites d' introspection qui permettent d'en tirer veritablement profit. 

Compte tenu de la popularite du langage C++, nous avons introduit de nombreuses remar- 
ques threes En C++. Elles mettent 1' accent sur les liens etroits qui existent entre Java et C++, 
ainsi que sur leurs differences. Elles offriront des passerelles utiles non seulement au pro- 
grammeur C++ qui apprend ici Java, mais egalement au lecteur qui, apres la maitrise de Java, 
souhaitera aborder l'etude de C++ 2 . 



1. II existe une troisieme edition de Java, J2ME (Java 2 Micro Edition), destinee aux developpements d' applications 
"embarquees" pour les telephones mobiles, les assistants personnels et divers appareils electroniques grand public. 

2. L'ouvrage Apprendre le C++, du meme auteur, chez le meme editeur, s'adresse a un public ayant deja la maitrise 
d'un langage tel que Java. 
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Presentation de Java 



Apres un tres bref historique du langage Java montrant dans quel esprit il a ete cree, nous en 
presenterons les principales caracteristiques. Nous verrons tout d'abord que Java est un lan- 
gage objet et nous exposerons les concepts majeurs de la programmation orientee objet. Puis 
nous ferons la distinction entre les programmes utilisant une interface console et les program- 
mes utilisant une interface graphique, ce qui nous amenera a parler des possibilites de pro- 
grammation evenementielle qui sont offertes par Java sous la forme de classes standard. 
Enfin, nous montrerons que Java est le premier langage a offrir une portability aussi avancee. 

1 Petit historique du langage 

On peut faire remonter la naissance de Java a 1991. A cette epoque, des ingenieurs de chez 
SUN ont cherche a concevoir un langage applicable a de petits appareils electriques (on parle 
de code embarque). Pour ce faire, ils se sont fondes sur une syntaxe tres proche de celle de 
C++, en reprenant le concept de machine virtuelle deja exploite auparavant par le Pascal 
UCSD. L'idee consistait a traduire d'abord un programme source, non pas directement en 
langage machine, mais dans un pseudo langage universel, disposant des fonctionnalites com- 
munes a toutes les machines. Ce code intermediate, dont on dit qu'il est forme de byte 
codes 1 , se trouve ainsi compact et portable sur n'importe quelle machine ; il suffit simple- 
ment que cette derniere dispose d'un programme approprie (on parle alors de machine vir- 
tuelle) permettant de F interpreter dans le langage de la machine concernee. 



1. Conformement a la tradition, nous n'avons pas cherche a traduire ce terme. 
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En fait, ce projet de langage pour code embarque n'a pas abouti en tant que tel. Mais ces con- 
cepts ont ete repris en 1995 dans la realisation du logiciel Hot Java, un navigateur Web ecrit 
par SUN en Java, et capable d'executer des applets ecrits precisement en byte codes. 

Les autres navigateurs Web ont suivi, ce qui a contribue a l'essor du langage qui a beaucoup 
evolue depuis cette date, sous forme de versions successives : 1.01 et 1.02 en 1996, 1.1 en 98 
et 1.2 (finalement rebaptisee Java 2) en 1999, 1.3 en 2000, 1.4 en 2002, 5.0 en 2004 (toujours 
appelees Java 2). Ainsi parle-t-on du J2SE 1.4 (Java 2 Standard Edition 1.4) basee sur le 
JDK 1.4 (Java Development Kit 1.4), plus recemment du J2SE5.0 (JDK 5.0) ou encore de 
Java 5. En revanche, la derniere version s'intitule JSE 6 (le 2 a disparu !), ou plus simplement 
Java 6 1 . 

On notera que, au ft! des differentes versions, les aspects fondamentaux du langage ont peu 
change (ils ont quand meme ete completes de facon substancielle par Java 5, notamment par 
l'introduction de la programmation generique et du remaniement des "collections"). En 
revanche, les bibliotheques standards (API) ont beaucoup evolue, a la fois par des modifica- 
tions et par des ajouts. II en va d'ailleurs de meme des ensembles de specifications accompa- 
gnant chaque version standard de Java (J2EE jusqu'a la version 4 et JEE depuis la version 5) . 

2 Java et la programmation orientee objet 

La P.O.O. (programmation orientee objet) possede de nombreuses vertus universellement 
reconnues desormais. Notamment, elle ne renie pas la programmation structuree (elle se 
fonde sur elle), elle contribue a la fiabilite des logiciels et elle facilite la reutilisation de code 
existant. Elle introduit de nouveaux concepts, en particulier ceux d'objets, d' encapsulation, 
de classe et d'heritage. 

2.1 Les concepts d'objet et d'encapsulation 

En programmation structuree, un programme est forme de la reunion de differentes procedu- 
res et de differentes structures de donnees generalement independantes de ces procedures. 

En P.O.O. , un programme met en ceuvre differents objets. Chaque objet associe des donnees 
et des methodes agissant exclusivement sur les donnees de l'objet. Notez que le vocabulaire 
evolue quelque peu : on parlera de methodes plutot que de procedures ; en revanche, on 
pourra utiliser indifferemment le mot donnees ou le mot champ. 

Mais cette association est plus qu'une simple juxtaposition. En effet, dans ce que Ton pour- 
rait qualifier de P.O.O. "pure", on realise ce que Ton nomme une encapsulation des donnees. 
Cela signifie qu'il n'est pas possible d'agir directement sur les donnees d'un objet ; il est 
necessaire de passer par ses methodes, qui jouent ainsi le role d'interface obligatoire. On tra- 



1. Attention, la documentation de reference de Sun comporte toujours les numeros de version de la forme 1.1, 
1 .2, 1 .3, 1 .4, 1.5 (pour Java 5) et 1 .6 (pour Java 6). 
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duit parfois cela en disant que l'appel d'une methode est en fait l'envoi d'un message a 
1' objet. 

Le grand merite de F encapsulation est que, vu de l'exterieur, un objet se caracterise unique- 
ment par les specifications de ses methodes, la maniere dont sont reellement implantees les 
donnees etant sans importance. On decrit souvent une telle situation en disant qu'elle realise 
une abstraction des donnees (ce qui exprime bien que les details concrets d' implementation 
sont caches). A ce propos, on peut remarquer qu'en programmation structuree, une procedure 
pouvait egalement etre caracterisee (de l'exterieur) par ses specifications, mais que, faute 
d' encapsulation, l'abstraction des donnees n'etait pas realisee. 

L' encapsulation des donnees presente un interet manifeste en matiere de qualite de logiciel. 
Elle facilite considerablement la maintenance : une modification eventuelle de la structure 
des donnees d'un objet n'a d'incidence que sur l'objet lui-meme ; les utilisateurs de l'objet 
ne seront pas concernes par la teneur de cette modification (ce qui n'etait bien sur pas le cas 
avec la programmation structuree). De la meme maniere, 1' encapsulation des donnees facilite 
grandement la reutilisation d'un objet. 

2.2 Le concept de classe 

Le concept de classe correspond simplement a la generalisation de la notion de type que Ton 
rencontre dans les langages classiques. En effet, une classe n'est rien d' autre que la descrip- 
tion d'un ensemble d'objets ayant une structure de donnees commune et disposant des 
memes methodes. Les objets apparaissent alors comme des variables d'un tel type classe (en 
P.O.O., on dit aussi qu'un objet est une instance de sa classe). Bien entendu, seule la structure 
est commune, les valeurs des champs etant propres a chaque objet. En revanche, les metho- 
des sont effectivement communes a F ensemble des objets d'une meme classe. 

Lorsque, comme cela arrive parfois dans l'ecriture d'interfaces graphiques, on est amene a ne 
creer qu'un seul objet d'une classe donnee, la distinction entre les notions d'objet et de classe 
n'est pas toujours tres evidente. 

En revanche, lorsque Ton dispose de plusieurs objets d'une meme classe, le principe 
d' encapsulation s'appliquera a la classe et non a chacune de ses instances, comme nous le 
verrons. 

2.3 L'heritage 

Un autre concept important en P.O.O. est celui d'heritage. II permet de definir une nouvelle 
classe a partir d'une classe existante (qu'on reutilise en bloc !), a laquelle on ajoute de nou- 
velles donnees et de nouvelles methodes. La conception de la nouvelle classe, qui herite des 
proprietes et des aptitudes de l'ancienne, peut ainsi s'appuyer sur des realisations anterieures 
parfaitement au point et les specialiser a volonte. Comme on peut s'en douter, l'heritage faci- 
lite largement la reutilisation de produits existants, d'autant plus qu'il peut etre reitere autant 
de fois que necessaire (la classe C peut heriter de B, qui elle-meme herite de A). 



Presentation de Java 

Chapitre 1 



Cette technique s'appliquera aussi bien aux classes que vous serez amenes a developper 
qu'aux tres nombreuses classes fournies es en standard avec Java. 

Certains langages, tels C++, offrent la possibility d'un heritage multiple : une meme classe 
peut heriter simultanement de plusieurs autres. Ce n'est pas le cas de Java, mais nous verrons 
que la notion d' interface permet de traiter plus elegamment les situations correspondantes. 

2.4 Le polymorphisme 

En Java, comme generalement, en P.O.O., une classe peut "redefinir" (c'est-a-dire modifier) 
certaines des methodes heritees de sa classe de base. Cette possibilite est la cle de ce que Ton 
nomme le "polymorphisme", c'est-a-dire la possibilite de traiter de la meme maniere des 
objets de types differents, pour peu qu'ils soient issus de classes derivees d'une meme classe 
de base. Plus precisement, on utilise chaque objet comme s'il etait de cette classe de base, 
mais son comportement effectif depend de sa classe effective (derivee de cette classe de 
base), en particulier de la maniere dont ses propres methodes ont ete redefinies. Le polymor- 
phisme permet d'ajouter de nouveaux objets dans un scenario preetabli et, eventuellement, 
ecrit avant d' avoir connaissance du type exact de ces objets. 

2.5 Java est presque un pur langage de P.O.O. 

Certains langages ont ete concus pour appliquer a la lettre les principes de P.O.O. C'est 
notamment le cas de Simula, Smalltalk et de Eiffel. Dans ce cas, tout est objet (ou instance de 
classe) et 1' encapsulation des donnees est absolue. Les procedures sont obligatoirement des 
methodes, ce qui revient a dire qu'il n'existe pas de procedures independantes, c'est-a-dire 
susceptibles de s'executer independamment de tout objet. 

D' autres langages, comme Pascal ou C++, ont cherche a appliquer une "philosophie objet" a 
un langage classique. Les objets y cohabitent alors avec des variables usuelles. II existe a la 
fois des methodes, applicables a un objet, et des procedures independantes. A a la limite, on 
peut realiser un programme ne comportant aucun objet. 

Java se veut un langage de la premiere categorie, autrement dit un pur langage de P.O.O. Par 
nature, un programme s'y trouvera forme d'une classe ou de la reunion de plusieurs classes et 
il instanciera des objets. II sera impossible de creer un programme n'utilisant aucune classe. 
Cependant, il faut apporter quelques nuances qui troublent tres legerement la purete du lan- 
gage. 

• Java dispose de types dits primitifs pour representer les entiers, les flottants, les caracteres 
et les booleens. Les variables correspondantes ne sont pas des objets. Certes, la plupart du 
temps, ces types primitifs seront utilises pour definir les champs d'une classe, done finale- 
ment d'un objet ; cependant, il y aura des exceptions... 

• Une classe pourra comporter des methodes particulieres dites methodes de classe (declarees 
avec le mot-cle static) qui seront utilisables de facon independante d'un objet. Comme ces 
methodes peuvent declarer localement des variables d'un type primitif, on voit qu'on peut 
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ainsi retrouver les possibilites des procedures ou des fonctions des langages non objet. La 
seule difference (purement syntaxique) viendra de ce que ces methodes seront localisees ar- 
tificiellement dans une classe (on verra qu'il existe une telle methode nommee main jouant 
le role de programme principal). A la limite, on peut concevoir un programme ne compor- 
tant aucun objet (mais obligatoirement au moins une classe). C'est d'ailleurs cette particu- 
larite que nous exploiterons pour vous exposer les bases du langage, en dehors de tout 
contexte objet. 

• L' encapsulation se trouve naturellement induite par la syntaxe du langage mais elle n'est pas 
absolue. 

3 Java et la programmation evenementielle 

3.1 Interface console ou interface graphique 

Actuellement, on peut distinguer deux grandes categories de programmes, en se fondant sur 
leur interface avec l'utilisateur, c'est-a-dire sur la maniere dont se font les echanges d'infor- 
mations entre l'utilisateur et le programme : 

• les programmes a interface console, 

• les programmes a interface graphique. 

3.1.1 Les programmes a interface console (ou en ligne de commande) 

Historiquement, ce sont les plus anciens. Dans de tels programmes, on fournit des informa- 
tions a Fecran sous forme de lignes de texte s'affichant sequentiellement, c'est-a-dire les 
unes a la suite des autres. Pour fournir des informations au programme, l'utilisateur frappe 
des caracteres au clavier (generalement un "echo" apparait a l'ecran). 

Entre nt dans cette categorie : 

• les programmes fonctionnant sur PC sous DOS ou, plus frequemment, dans une fenetre 
DOS de Windows, 

• les programmes fonctionnant sous Unix ou Linux et s'executant dans une "fenetre de com- 
mande". 

Avec une interface console, c'est le programme qui decide de l'enchainement des 
operations : l'utilisateur est sollicite au moment voulu pour fournir les informations deman- 
dees 1 . 



1 . En toute rigueur, les informations fournies peuvent influer sur le deroulement ulterieur du programme ; il 
n'en reste pas moins que l'interface console n'offre pas a l'utilisateur la sensation d'initiative qu'il trouvera dans 
une interface graphique. 
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3.1.2 Les programmes a interface graphique (G.U.I.) 

Dans ces programmes, la communication avec l'utilisateur se fait par 1' intermediate de com- 
posants tels que les menus deroulants, les menus surgissants, les barres d'outils ou les boites 
de dialogue, ces dernieres pouvant renfermer des composants aussi varies que les boutons 
poussoirs, les cases a cocher, les boutons radio, les boites de saisie, les listes deroulantes... 

L'utilisateur a 1' impression de piloter le programme, qui semble repondre a n'importe 
laquelle de ses demandes. D'ailleurs, on parle souvent dans ce cas de programmation evene- 
mentielle, expression qui traduit bien le fait que le programme reagit a des evenements pro- 
voques (pour la plupart) par l'utilisateur. 

On notera que le terme G.U.I. {Graphical User Interface) tend a se generaliser pour designer 
ce genre d' interface. Manifestement, il met en avant le fait que, pour permettre ce dialogue, 
on ne peut plus se contenter d'echanger du texte et qu'il faut effectivement etre capable de 
dessiner, done d'employer une interface graphique. II n'en reste pas moins que l'aspect le 
plus caracteristique de ce type de programme est dans l'aspect evenementiel 1 . 

3.2 Les fenetres associees a un programme 

3.2.1 Cas d'une interface console 

L' interface console n' utilise qu'une seule fenetre (dans certains anciens environnement, la fenetre 
n'etait meme pas visible, car elle occupait tout l'ecran). Celle-ci ne possede qu'un petit nombre de 
fonctionnalites : deplacement, fermeture, parfois changement de taille et defilement. 

3.2.2 Cas d'une interface graphique 

L'interface graphique utilise une fenetre principale qui s'ouvre au lancement du programme. II est 
possible que d'autres fenetre apparaissent par la suite : l'exemple classique est celui d'un logiciel 
de traitement de texte qui manipule differents documents associes chacun a une fenetre. 

L'affichage des informations dans ces fenetres ne se fait plus sequentiellement. II est genera - 
lement necessaire de prendre en compte l'aspect "coordonnees". En contrepartie, on peut 
afficher du texte en n'importe quel emplacement de la fenetre, utiliser des polices differentes, 
jouer sur les couleurs, faire des dessins, afficher des images... 

3.3 Java et les interfaces 

3.3.1 La gestion des interfaces graphiques est integree dans Java 

Dans la plupart des langages, on dispose d' instructions ou de procedures standard permettant 
de realiser les entrees-sorties en mode console. 



1. Bien entendu, une des "retombees" de l'utilisation d'une interface graphique est que le programme pourra 
afficher des graphiques, des dessins, des images... 
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En revanche, les interfaces graphiques doivent etre programmees en recourant a des instruc- 
tions ou a des bibliotheques specifiques a chaque environnement (par exemple XI 1 ou Motif 
sous Unix, API Windows , MFC ou Object Windows sous Windows). 

L'un des grands merites de Java est d'integrer des outils (en fait des classes standard) de ges- 
tion des interfaces graphiques. Non seulement on pourra utiliser le meme code source pour 
differents environnements mais, de plus, un programme deja compile (byte codes) pourra 
s'executer sans modification sur differentes machines. 

3.3.2 Applications et applets 

A l'origine, Java a ete concu pour realiser des applets s'executant dans des pages Web. En 
fait, Java permet d'ecrire des programmes independants du Web. On parle alors d' applica- 
tions (parfois de "vraies applications"). 

Les fonctionnalites graphiques a employer sont quasiment les memes pour les applets et les 
applications. D'ailleurs, dans cet ouvrage, nous presenterons l'essentiel de Java en conside- 
rant des applications. Un seul chapitre sera necessaire pour presenter ce qui est specifique 
aux applets. 

Theoriquement, une applet est faite pour que son code (compile) soit telecharge dans une 
page Web. Autrement dit, il peut sembler indispensable de recourir a un navigateur pour 
l'executer (pas pour la compiler). En fait, quel que soit 1' environnement, vous disposerez tou- 
jours d'un visualisateur d'applets vous permettant d'executer une applet en dehors du Web. 

3.3.3 On peut disposer d'une interface console en Java 

A priori, Java a ete concu pour developper des applets ou des applications utilisant des inter- 
faces graphiques. 

En fait, en plus des fenetres graphiques qu'elle est amenee a creer, toute application dispose 
automatiquement d'une fenetre dans laquelle elle peut (sans y etre obligee) realiser des 
entrees-sorties en mode console. 

Cette possibilite pourra s'averer tres precieuse lors de la phase d'apprentissage du langage. 
En effet, on pourra commencer a ecrire du code, sans avoir a maitriser les subtilites de la ges- 
tion des interfaces graphiques. Cet aspect sera d'autant plus interessant que, comme on le 
verra par la suite, Java permet de lancer une application sans que cette derniere ne soit obli- 
gee de creer une fenetre principale. 

On pourra aussi utiliser une fenetre console lors de la mise au point d'un programme pour y 
afficher differentes informations de trafage du code. 

Enfin, vous disposerez automatiquement d'une fenetre console si vous lancez une applet 
depuis le visualisateur d' applet. 
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4 Java et la portability 

Dans la plupart des langages, on dit qu'un programme est portable car un meme code source 
peut etre exploite dans des environnements differents moyennant simplement une nouvelle 
compilation. 

En Java, la portability va plus loin. En effet, comme nous l'avons evoque precedemment, la 
compilation d'un code source produit, non pas des instructions machine, mais un code inter- 
mediate forme de byte codes. D'une part, ce code est exactement le meme, quel que soit le 
compilateur et Fenvironnement concernes. D'autre part, ces byte codes sont executables dans 
toute implementation disposant du logiciel d' interpretation nomme machine virtuelle 1 ou, 
parfois, systeme d' execution Java. 

De surcroit, Java definit exactement les caracteristiques des types primitifs servant a repre- 
senter les caracteres, les entiers et les flottants. Cela concerne non seulement la taille de 
l'emplacement memoire, mais aussi le comportement arithmetique correspondant. Ainsi, 
quelle que soit la machine, une valeur de type float (reel) aura exactement meme taille, 
memes limites et meme precision. Java est ainsi le premier langage qui assure qu'un meme 
programme, execute dans des environnements differents, fournira les memes resultats 2 . 



1. JVM (abreviation de Java Virtual Machine). 

2. A 1'erreur de representation pres (qui, dans des calculs complexes, peut quant meme avoir une incidence 
importante !). 
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Ce chapitre constitue une premiere approche d'un programme Java, fondee sur quelques 
exemples commentes. Vous y verrez, de maniere informelle pour l'instant, comment s'expri- 
ment les instructions de base (declaration, affectation, ecriture...), ainsi que deux structures 
fondamentales (boucle avec compteur et choix). Cela nous permettra par la suite d'illustrer 
certaines notions par des programmes complets, comprehensibles avant meme que nous 
n'ayons effectue une etude detaillee des instructions correspondantes. 

Nous degagerons ensuite quelques regies generates concernant Fecriture d'un programme. 
Enfin, nous montrerons comment mettre en ceuvre un programme Java, de sa saisie a son exe- 
cution, ce qui vous permettra de vous familiariser avec votre propre environnement de deve- 
loppement. 

Notez que nous exploiterons ici les possibilites de simplification presentees au chapitre pre- 
cedent. D'une part, nous nous limiterons a des programmes utilisant une interface de type 
console ; d'autre part, nous ne ferons pas intervenir d'objets. Autrement dit, ce chapitre se 
bornera a vous montrer comment s'expriment en Java des concepts que vous avez deja ren- 
contres dans d'autres langages (C, C++, Visual Basic, C#, PHP...). 

1 Premier exemple de programme Java 

Voici un exemple tres simple de programme qui se contente d'afficher dans la fenetre console 
le texte : "Mon premier programme Java". 
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public class PremProg 

{ public static void main (String args[ ] ) 

{ System. out .println ("Mon premier programme Java") ; 

} 

} 

Mon premier programme Java 

1 .1 Structure generale du programme 

Vous constatez que, globalement, sa structure se presente ainsi 1 : 

public class PremProg 

{ 

} 

Elle correspond theoriquement a la definition d'une classe nommee PremProg. La premiere 
ligne identifie cette classe ; elle est suivie d'un bloc, c'est-a-dire d' instructions delimitees par 
des accolades { et } qui definissent le contenu de cette classe. Ici, cette derniere est reduite a 
la seule definition d'une "methode" particuliere nommee main : 

public static void main (String [ ] args) 

{ System. out .println ("Mon premier programme Java") ; 

} 

La encore, une premiere ligne identifie la methode ; elle est suivie d'un bloc ({ }) qui en 

fournit les differentes instructions. 

Pour F instant, vous pouvez vous contenter d'utiliser un tel canevas, sans vraiment connaitre 
les notions de classe et de methode. II vous suffit simplement de placer dans le bloc le plus 
interne les instructions de votre choix, comme vous le feriez dans le programme principal (ou 
la fonction principale) d'un autre langage. 

Simplement, afin d'utiliser des maintenant le vocabulaire approprie, nous parlerons de la 
methode main de notre programme forme ici d'une seule classe nommee PremProg. 
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Si vous souhaitez en savoir un peu plus, voici quelques indications supplementaires que 
vous retrouverez lorsque nous etudierons les classes. 

1 Le mot-cle static precise que la methode main de la classe PremProg n'est pas liee a 
une instance (objet) particuliere de la classe. C'est ce qui fait de cette methode l'equi- 
valent d'une procedure ou d'une fonction usuelle des autres langages. En outre, comme 



1 . Contrairement a ce qui se produit en C++, on ne trouve pas de point- virgule a la fin de la definition de la 
classe. 
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elle porte le nom main, il s'agit de la fonction principale, c'est-a-dire de l'equivalent de 
la fonction main du C ou du programme principal de Pascal. 

2 Le parametre String [] args de la fonction main permet de recuperet - des arguments 
transmis au programme au moment de son lancement. On peut lancer un programme 
sans fournir d'arguments, mais l'indication String args[] est obligatoire (en C/C++, on 
trouve des parametres similaires dans la fonction main, mais ils sont facultatifs). 

Vous pouvez indifferemment ecrire Stringf] args ou String args[]. Vous verrez plus tard 
que ce parametre args est un tableau d'objets de type String, servant a representer des 
chaines de caracteres. Comme pour tout parametre d'une fonction, son nom peut etre 
choisi librement ; vous pourriez tout aussi bien utiliser infos, valeurs, param... Toute- 
fois, la tradition veut qu'on utilise plutot args. 

3 Le mot-cle public dans public class PremProg sert a definir les droits d'acces des autres 
classes (en fait de leurs methodes) a la classe PremProg. Comme manifestement, 
aucune autre classe n'a besoin de PremProg, le mot-cle public pourrait etre omis. 
Cependant, comme cela pourrait vous conduire a prendre de mauvaises habitudes en ce 
qui concerne 1' organisation de vos fichiers source, nous vous conseillons de le conser- 
ver (au moins pour 1' instant). 

4 Le mot-cle public dans public static void main est obligatoire pour que votre pro- 
gramme puisse s'executer. Ici, il ne s'agit plus veritablement d'un probleme de droit 
d'acces, mais plutot d'une convention qui permet a la machine virtuelle d'acceder a la 
methode main. Notez que vous pouvez inverser l'ordre des mots-cles public et static en 
ecrivant static public void main. 

1 .2 Contenu du programme 

Notre programme comporte ici une seule instruction : 

System. out. println ("Mon premier programme Java") ; 

Si vous aviez simplement trouve 

println ("Mon premier programme Java") ; 

les choses vous auraient probablement paru assez intuitives, le mot println apparaissant 
comme l'abreviation de print line (affichage suivi d'un changement de ligne). 

Pour l'instant, vous pouvez vous contenter de considerer que System.out.println correspond a 
une methode d' affichage dans la fenetre console, methode a laquelle on mentionne un texte a 
afficher sous forme d'une constante chaine usuelle (entre guillemets, comme dans la plupart 
des langages). 

II existe egalement une methode System.out.print qui fait la meme chose, avec cette seule dif- 
ference qu'elle ne provoque pas de changement de ligne apres affichage. Ainsi, l'unique ins- 
truction de notre programme pourrait etre (artificiellement) remplacee par : 

System.out.print ("Mon premier programme ") ; 
System.out.println ("Java") ; 
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Nous aurons bientot 1' occasion de voir comment afficher autre chose que des chaines 
constantes. Sachez que la notation System.out.println fait egalement appel aux notions 
d'objet et de methode. Plus precisement, System designe une classe dans laquelle se 
trouve defini un champ donnee out, representant la fenetre console. Ici encore, ce champ 
possede Fattribut static, ce qui signifie qu'il existe independamment de tout objet de type 
System. C'est pourquoi on le designe par System.out (alors qu'un champ non statique 
serait repere par un nom d'objet et non plus par un nom de classe). Enfin, la methode 
println est une methode (classique, cette fois) de la classe dont est issu Fobjet out (il 
s'agit de la classe PrintStream). La notation System.out.println represente l'appel de la 
methode println associee a l'objet System.out. 

Par ailleurs, le JDK 5.0 a introduit une methode printf permettant de "formater" Faffi- 
chage des informations, a la maniere de l'instruction printf du langage C. 



2 Execution d'un programme Java 

Pour mettre en ceuvre notre precedent programme, il faut bien sur le saisir et le sauvegarder 
dans un fichier. Ici, ce dernier devra imperativement se nommer PremProg.java. En effet, 
nous verrons que, quel que soit Fenvironnement concerne, le code source d'une classe publi- 
que 1 doit toujours se trouver dans un fichier portant le meme nom et possedant Fextension 
java. 

Ensuite, on precede a la compilation de ce fichier source. Rappelons que celle-ci produit non 
pas du code machine, mais un code intermediaire forme de bytecodes. Si la compilation s'est 
bien deroulee, on obtiendra un fichier portant le meme nom que le fichier source et Fexten- 
sion class, done ici PremProg. class. On pourra lancer l'execution des byte codes ainsi obte- 
nus par F intermediaire de la machine virtuelle Java. Bien entendu, on pourra executer autant 
de fois qu'on le voudra un meme programme, sans avoir besoin de le recompiler. 

La demarche a employer pour proceder a ces differentes etapes depend tout naturellement de 
Fenvironnement de developpement avec lequel on travaille. S'il s'agit du JDK 2 de SUN, on 
compilera avec la commande : 

javac PremProg.java 

On executera avec la commande suivante (attention a ne pas mentionner d' extension a la 
suite du nom du programme) : 

java PremProg 



1 . Certes, comme il a ete dit precedemment, nous ne sommes pas obliges de declarer notre classe publique. Tou- 
tefois, cette possibility est deconseillee pour l'instant. 

2. Java Developpment Kit : kit de developpement Java. 
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A la suite de cette derniere commande, on obtiendra les resultats dans la meme fenetre, qui 
ressemblera done a ceci (en fait, les commandes seront probablement precedees d'un 
"prompt") : 

javac PremProg . j ava 
java PremProg 

Mori premier programme Java 

Exemple d 'execution du programme PremProg ( 1) 

Avec un environnement de developpement "integre", on sera amene a utiliser des menus pour 
commander ces deux etapes. Le lancement de F execution creera une fenetre console qui res- 
semblera a ceci (ici, nous avons employe le produit Eclipse 3.1) : 



? Java - PremProg.java - SDK Eclipse 
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Exemple d' execution du programme PremProg (2) 




Precautions 



Voici quelques indications concernant quelques problemes que vous pouvez rencontrer. 

1 Certains environnements integres peuvent generer plus ou moins automatiquement du 
code, ou tout au moins un squelette a completer. Si vous exploitez ces possibilites, vous 
risquez de rencontrer des instructions dont nous n' avons pas encore parle. Dans ce cas, 
le plus simple est de les eliminer. Cela concerne tout particulierement une instruction 
d'attribution de classe a un "paquetage", de la forme : 

package xxxxx ; 
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La conserver pourrait vous imposer des contraintes sur le repertoire (dossier) contenant 
votre fichier source. 

2 Prenez bien soin de respecter la casse (majuscules/minuscules) dans les noms de 
fichier. Une erreur de casse abouti ail meme comportement qu'une erreur de nom. 
Attention : le comportement de Windows peut etre deroutant. En effet, supposons que 
vous ayez d'abord enregistre votre programme dans un fichier Premprog (au lieu de 
PremProg). Apres avoir decouvert votre erreur, vous chercherez probablement a creer 
un nouveau fichier (par une commande du type Save as) avec le bon nom PremProg. 
Dans ce cas, Windows vous signalera que ce fichier existe deja. En fait, si vous deman- 
dez a le remplacer, il prendra bien en compte le nouveau nom. Autrement dit, tout se 
passe comme si la casse n'etait pas significative pour Windows, mais il l'utilise quand 
meme dans le nom effectivement attribue au fichier. 

3 Si vous transferez des fichiers d'un environnement a un autre, il se peut qu'en cours de 
route, vous passiez de noms de fichiers longs (nombre de caracteres quelconque, nom- 
bre d' extensions quelconque et de longueur quelconque 1 ) a des noms de fichiers courts 
(8 caracteres maximum et une seule extension de 3 caracteres maximum). Dans ce cas, 
vous perdrez obligatoirement l'extension java. II vous faudra penser a la restaurer avant 
compilation. 

4 Certains environnements integres ferment automatiquement la fenetre console lorsque 
le programme a fini de s'executer. Dans ce cas, le programme precedent laissera peu de 
traces de son passage. Vous pourrez vous arranger pour qu'il ne s'arrete pas tout de 
suite, en lui ajoutant une instruction de lecture au clavier, comme vous apprendrez a le 
faire au paragraphe 4. 




Informations complementaires 



Pour F instant, nous pouvons nous permettre de confondre la notion de programme avec 
celle de classe. Plus tard, vous verrez que lorsque vous demandez a la machine virtuelle 
d'executer un fichier xxxx. class, elle y recherche une fonction publique de nom main. Si 
elle la trouve, elle l'execute ; dans le cas contraire, elle indique une erreur. 

3 Quelques instructions de base 

L'exemple du paragraphe 1 a permis de presenter le canevas general a utiliser pour ecrire un 
programme en Java. Voici maintenant un exemple un peu plus important, accompagne de ce 
que son execution afficherait dans la fenetre console : 



1. Malgre tout, le nombre total de caracteres ne doit pas exceder 255. 
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public class Exemple 
{ 

public static void main (String [ ] args) 
{ 

int n ; 
double x ; 
n = 5 ; 

x = 2*n + 1.5 ; 

System. out. println ("n = " + n) ; 
System. out. println ("x = " + x) ; 
double y ; 
y = n * x + 12 ; 

System . out . println ("valeur de y : " + y) ; 

} 

} 

n = 5 
x = 11.5 

valeur de y : 69.5 

Exemple de programme Java 

Bien entendu, nous avons utilise le meme canevas que precedemment avec un autre nom de 
classe (ici Exemple) : 

public class Exemple 

{ public static void main (String! ] args) 

{ 

} 

} 

Les deux premieres instructions de notre fonction main sont des declarations classiques : 

int n ; 
double x ; 

La premiere precise que la variable n est de type int, c'est-a-dire qu'elle est destinee a conte- 
nir des nombres entiers (relatifs). Comme la plupart des langages, Java dispose de plusieurs 
types entiers. De la meme maniere, la seconde instruction precise que x est une variable de 
type double, c'est-a-dire destinee a contenir des nombres flottants en "double precision" 
(approximation de nombres reels). Nous verrons que Java dispose de deux types de flottants, 
le second se nommant^oaf (nous ne 1' avons pas utilise ici car il aurait fait intervenir des pro- 
blemes de conversion des constantes flottantes). 

Comme dans la plupart des langages modernes, les declarations sont obligatoires en Java. 
Cependant, il n'est pas necessaire qu'elles soient regroupees en debut de programme (comme 
cela est le cas en C ou en Pascal) ; il suffit simplement qu'une variable ait ete declaree avant 
d'etre utilisee. 
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Les instructions suivantes sont des affectations classiques : 

n = 5 ; 

x = 2*n + 1.5 ; 

Les deux instructions suivantes font appel a la fonction System.out.println deja entrevue au 
paragraphe 1 : 

System.out.println ("n = " + n) ; 
System.out.println ("x = " + x) ; 

Mais cette fois, vous constatez que son argument ne se limite plus a une simple constante 
chaine. En Java, l'expression "n = " + n est interpretee comme la concatenation de la chaine 
constante "n = " avec le resultat de la conversion en chaine de la valeur de la variable n. Une 
telle conversion fournit en fait la suite de caracteres correspondant a l'ecriture du nombre en 
decimal. 

La meme remarque s'applique a l'expression "x = " + x. Nous verrons que l'operateur + pos- 
sede une propriete interessante : des que l'un de ses deux operandes est de type chaine, 
1' autre est converti en chaine. 

La suite du programme est classique. On y note simplement une declaration (tardive) de la 
variable y. Elle est autorisee a ce niveau car y n'a pas ete utilisee dans les instructions prece- 
dentes. 



1 Aucun objet n'apparait dans ce programme. Les variables n, x et y sont analogues aux 
variables qu'on rencontre dans les autres langages. En fait, seule la presence artificielle de 
la classe Exemple distingue ce programme d'un programme C. 

2 Si, connaissant le C, vous essayez de remplacer les declarations de type double par des 
declarations de type float, vous serez certainement surpris de decouvrir une erreur de 
compilation. Cela provient d'une part de ce que les constantes fiottantes sont implicite- 
ment de type double, d' autre part de ce que Java refuse la conversion implicite de dou- 
ble en float. 

3 En Java, il n'est pas aussi facile que dans les autres langages d'agir sur la maniere dont 
les nombres sont convertis en chaines, done affiches (gabarit, nombre de chiffres signi- 
ficatifs, notation exponentielle ou fiottante...). Bien entendu, il reste toujours possible 
de developper des outils dans ce sens. 

4 Avec une instruction telle que : 

System.out.println ("resultats = ", a + b*x) ; 

on affichera a la suite du texte "resultats = ", la valeur de a suivie de celle de b*x. Pour 
obtenir celle de l'expression a + b*x, il faudra proceder ainsi : 

System.out.println ("resultats = ", (a + b*x) ) ; 




Remarqi 
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4 Lecture d'informations au clavier 

Java est avant tout destine a developper des applications ou des applets utilisant des interfaces 
graphiques. Mais comme nous l'avons deja signale, la programmation des interfaces graphi- 
ques necessite de nombreuses connaissances, y compris celles relatives a la programmation 
orientee objet. Pour faciliter l'apprentissage du langage, il est de loin preferable de commen- 
cer par realiser des programmes travaillant en mode console. 

4.1 Presentation d'une classe de lecture au clavier 

Comme nous l'avons vu precedemment, l'affichage dans la fenetre console ne presente pas 
de difficultes puisqu'il suffit de recourir a l'une des fonctions System.out.println ou Sys- 
tem.out.print. Malheureusement, Java ne prevoit rien de comparable pour la lecture au cla- 
vier. 

En fait, il est toujours possible de developper une petite classe offrant les services de base que 
sont la lecture d'un entier, d'un fiottant ou d'un caractere. Vous trouverez une telle classe 
sous le nom Clavier.java parmi les fichiers source disponibles en telechargement sur 
www.editions-eyrolles.com, ainsi que sa liste complete en annexe B. II n'est pas necessaire 
de chercher a en comprendre le fonctionnement pour Finstant. II vous suffit de savoir qu'elle 
contient des fonctions 1 de lecture au clavier, parmi lesquelles : 

• Clavier.lirelntf) fournit en resultat une valeur entiere lue au clavier, 

• Clavier.lireDouble() fournit en resultat une valeur de type double lue au clavier. 

Ainsi, voici comment nous pourrions demander a l'utilisateur de fournir un nombre entier 
qu'on place dans la variable nb : 

int nb ; 



System. out. print ("donnez un nombre entier : ") ; 

nb = Clavier . lirelnt () ; // () obligatoires pour une fonction sans arguments 

Nous utiliserons les possibilites de cette classe Clavier dans notre prochain exemple de pro- 
gramme, au paragraphe 4. 

Notez que nous nous sommes limites a la lecture d'une seule valeur par ligne. D'autre part, si 
l'utilisateur fournit une reponse incorrecte (par exemple 45e ou 3.5 pour un int, ou encore 
4.25.3 ou 2.3a2 pour un double), nous avons prevu que le programme s'interrompe avec le 
message : *** Erreur de donnee ***. 



1. Ici encore, nous parlons de fonctions, alors qu'il s'agit en realite de methodes statiques de la classe Clavier. 
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Utilisation de cette classe 



Pour pouvoir utiliser cette classe Clavier au sein d'un de vos programmes, vous disposez de 
plusieurs solutions. Pendant la phase d'apprentissage du langage, la demarche la plus simple 
consiste a : 

• recopier le fichier source Clavier.java dans le meme repertoire que celui ou se trouve le pro- 
gramme l'utilisant, 

• compiler une seule fois ce fichier. 

Par la suite, la classe Clavier.class sera automatiquement utilisee des que vous compilerez 
une autre classe y faisant appel. 

Avec certains environnements integres, vous aurez peut-etre besoin de mentionner cette 
classe Clavier.java au sein d'un fichier projet. En revanche, il ne sera plus necessaire qu'elle 
figure dans le meme repertoire que le programme l'utilisant. 



Comme vous le verrez dans le chapitre relatif aux classes, vous pourrez egalement utiliser 
la classe Clavier en la collant a la suite de votre fichier source, de maniere a obtenir deux 
classes dans un meme fichier. Dans ce cas, toutefois, il vous faudra supprimer le mot-cle 
public de la ligne public Class Clavier. 



Voici maintenant un exemple de programme comportant, en plus des instructions de base 
deja rencontrees, une structure de choix et une structure de boucle. II calcule les racines car- 
rees de 5 valeurs fournies en donnees. Les lectures au clavier sont realisees en utilisant la 
fonction Clavier.lirelntf) de la classe Clavier dont nous avons parle precedemment. 

// Calcul de racines carrees 

//La classe Racines utilise la classe Clavier 

public class Racines 

{ public static void main (String! ] args) 
{ final int NPOIS = 5 ; 
int i ; 
double x ; 
double racx ; 

System. out .println ("Bonjour") ; 

System. out .println ("Je vais vous calculer " + NPOIS + " racines carrees") ; 



Remarque 



4.3 



Boucles et choix 



for (i=0 ; KNEUIS ; i++) 

{ System. out. print ("Donnez un nombre : ") 
x = Clavier. lireDouble () ; 
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if (x < 0.0) 

System . out . println (x + " ne possede pas de racine carree") ; 
else 

{ racx = Math.sqrt(x) ; 

System. out. println (x + " a pour racine carree : " + racx) ; 

} 

} 

System . out . println ("Travail termine - Au revoir") ; 

} 

} 

Je vais vous calculer 5 racines carrees 
Donnez un nombre : 16 
16.0 a pour racine carree : 4.0 
Donnez un nombre : 2 

2.0a pour racine carree : 1.4142135623730951 
Donnez un nombre : -9 
-9.0 ne possede pas de racine carree 
Donnez un nombre : 5.25 

5.25 a pour racine carree : 2.29128784747792 

Donnez un nombre : 2.25 

2.25 a pour racine carree : 1.5 

Travail termine - Au revoir 

Exemple d'un programme de calcul de racines carrees 

Les deux premieres lignes commencent par // ; ce sont des commentaires. 
La premiere instruction de la fonction main est une declaration particuliere : 

final int NED IS = 5 ; 

Elle comporte une initialisation dont le role est intuitif : placer la valeur 5 dans NFOIS, avant 
le debut de l'execution. Quant au mot-cle final, il precise simplement que la valeur de la 
variable correspondante ne peut pas etre modifiee au cours de l'execution. En definitive, 
NFOIS est l'equivalent de ce qu'on appelle une constante symbolique dans certains langages. 

Les autres declarations ne posent pas de probleme, pas plus que les deux appels de Sys- 
tem.out.println. Notez simplement la concatenation de trois chaines dans le deuxieme de ces 
appels ("Je vais vous calculer " + NFOIS + " racines carrees"). 

Pour faire une repetition : I'instruction for 

En Java comme dans la plupart des langages, il existe plusieurs facons d'effectuer une repe- 
tition. Ici, nous avons utilise I'instruction for que les connaisseurs du C n'auront aucun mal a 
interpreter : 

for (i=0 ; KNEOIS ; i++) 



General ites 

Chapitre 2 

Son role est de repeter le bloc (delimite par des accolades { et }) figurant a sa suite, en respec- 
tant les consignes suivantes : 

• avant de commencer cette repetition, realiser : 

i = 0 

• avant chaque nouvelle execution du bloc (tour de boucle), examiner la condition : 

KNEOIS 

Si elle est satisfaite, executer le bloc indique, sinon passer a 1' instruction suivant ce bloc ; 

• a la fin de chaque execution du bloc, realiser : 

i++ 

Comme C, Java dispose d'une notation d' incrementation. Ici, ;++ est equivalente a ; = i+1. 

Pour faire des choix : I'instruction if 

Les lignes : 

if (x < 0.0) 

System. out. println (x + " ne possede pas de racine carree") ; 
else 

{ racx = Math.sqrt(x) ; 

System. out .println (x + " a pour racine carree : " + racx) ; 

} 

constituent une instruction de choix basee sur la condition x <0.0. Si cette derniere est vraie, 
on execute I'instruction suivante : 

System. out. println (x + " ne possede pas de racine carree") ; 

Si elle est fausse, on execute I'instruction suivant le mot else, c'est-a-dire ici le bloc : 

{ racx = Math.sqrt(x) ; 

System. out. println (x + " a pour racine carree : " + racx) ; 

} 

Notez l'appel de la fonction 1 Math.sqrt qui fournit une valeur de type double, correspondant 
a la racine carree de la valeur (de type double) qu'on lui fournit en argument. 

Les differentes sortes d'instructions 

Comme les autres langages, Java distingue les instructions de declaration (fournissant des 
informations au compilateur pour qu'il mene a bien sa traduction) et les instructions executa- 
bles (dont la traduction fournit des instructions en code machine, ou plutot ici en byte codes). 
Cependant, nous verrons que la liberte offerte dans l'emplacement des declarations conduit a 
les rendre partiellement executables. 

Quant aux (vraies) instructions executables, nous verrons qu'on peut les classer selon trois 
categories : 



1. Ici encore, il s'agit en fait d'une methode statique de la classe Math. 



5 - Regies generates d'ecriture 



25 



• les instructions simples, obligatoirement terminees par un point-virgule 1 , 

• les instructions de structuration telles que if ou for, 

• des blocs, delimites par { et } . 

Les deux dernieres ont une definition "recursive" puisqu'elles peuvent contenir, a leur tour, 
n'importe laquelle des trois formes. 

Lorsque nous parlerons d'instruction sans precisions supplementaires, il pourra s'agir de 
n'importe laquelle des trois formes ci-dessus. 

73* En C++ 

La syntaxe de Java est fondee sur celle de C++, ce qui fait que le precedent programme est 
facilement comprehensible pour un programmeur C ou C++. II existe cependant quelques 
petites differences. Ici, deja, vous constatez que le mot-cle const a ete remplace par final. 

Remarque 

Rappelons que certains environnements ferment automatiquement la fenetre console a la 
fin de F execution du programme. Pour continuer a la voir, il vous suffit d'ajouter, avant la 
fin de votre programme, une instruction : 

Clavier . lirelnt ( ) ; 

Votre programme ne s'interrompra pas tant que vous n'aurez pas fourni une valeur 
entiere (quelconque). 

5 Regies generales d'ecriture 

Ce paragraphe expose un certain nombre de regies generales intervenant dans l'ecriture d'un 
programme Java. Nous aborderons en particulier ce qu'on nomme les identificateurs et les 
mots-cles, le format libre dans lequel sont ecrites les instructions, l'usage des separateurs et 
des commentaires. Enfin, nous vous dirons un mot d' Unicode, le code universel utilise par 
Java pour representer les caracteres. 

5.1 Les identificateurs 

Dans un langage de programmation, un identificateur est une suite de caracteres servant a 
designer les differentes entites manipulees par un programme : variables, fonctions, classes, 
objets... 



1 . Notez la difference avec certains langages comme Pascal, dans lequel le point-virgule est un separateur des- 
tructions. 



En Java comme dans la plupart des autres langages, un identificateur est forme de lettres ou 
de chiffres, le premier caractere etant obligatoirement une lettre. Les lettres comprennent les 
majuscules A-Z et les minuscules a-z, ainsi que le caractere "souligne" (_) et le caractere 
Voici quelques identificateurs corrects : 

ligne Clavier valeur_5 _total _56 

Aucune limitation ne pese sur le nombre de caracteres, qui sont tous significatifs (en C, seuls 
les 32 premiers l'etaient). 

Notez bien que, comme en C (et contrairement a Pascal), on distingue les majuscules des 
minuscules. Ainsi, Ligne et ligne designent deux identificateurs differents ; il en va de meme 
pour PremProg et Premprog. 

Informations complementaires 

Bien qu'elles ne soient nullement imposees par le langage, certaines regies sont tradition- 
nellement utilisees dans le choix des identificateurs d'un programme Java. Ainsi, les 
noms de variables et les noms de fonctions sont ecrits en minuscules, sauf s'ils sont for- 
mes de la juxtaposition de plusieurs mots, auquel cas chaque mot sauf le premier com- 
porte une majuscule, par exemple : valeur, nombreValeurs, tauxEmprunt, 
nombreReponsesExactes. Les noms de classes suivent la meme regie, mais leur premiere 
lettre est ecrite en majuscules : Clavier, PremProg. Les noms de constantes sont ecrits 
entierement en majuscules. Notez que ces regies permettent de savoir que System est une 
classe et que out n'en est pas une. 

Les mots-cles 

Certains mots-cles sont reserves par le langage a un usage bien defini et ne peuvent pas etre 
utilises comme identificateurs. En voici la liste, par ordre alphabetique : 



abstract 


assert 


boolean 


break 


byte 


case 


catch 


char 


class 


const 


continue 


default 


do 


double 


else 


extends 


final 


finally 


float 


for 


goto 


if 


implements 


import 


instanceof 


int 


interface 


long 


native 


new 


null 


package 


private 


protected 


public 


return 


short 


static 


super 


switch 


synchronized 


this 


throw 


throws 


transient 


try- 


void 


volatile 


while 





1 . II est conseille d'eviter de 1' employer car il est utilise par Java dans ses mecanismes internes. 
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5.3 Les separateurs 

Dans notre langue ecrite, les mots sont separes par un espace, un signe de ponctuation ou une 
fin de ligne. 

II en va quasiment de meme en Java. Ainsi, dans un programme, deux identificateurs succes- 
sifs entre lesquels la syntaxe n' impose aucun signe particulier 1 doivent imperativement etre 
separes soit par un espace, soit par une fin de ligne. En revanche, des que la syntaxe impose 
un separateur quelconque, il n'est pas necessaire de prevoir d'espaces supplementaires, bien 
qu'en pratique cela ameliore la lisibilite du programme. 

Ainsi, vous ne pourrez pas remplacer : 

int x,y 

par 

intx, y 

En revanche, vous pourrez ecrire indifferemment : 

int n,compte,p, total, valeur ; 

ou, plus lisiblement : 

int n, compte, p, total, valeur ; 

voire : 

int n, 

compte, 
Pt 

total, 
valeur ; 



5.4 Le format libre 

Comme Pascal ou C, Java autorise une mise en page parfaitement libre. En particulier, une 
instruction peut s'etendre sur un nombre quelconque de lignes, et une meme ligne peut corn- 
porter autant d' instructions que voulu. Les fins de ligne ne jouent pas de role particulier, si ce 
n'est celui de separateur, au meme titre qu'un espace 2 (un identificateur ne pouvant etre 
coupe en deux par une fin de ligne. 

Bien entendu, cette liberte de mise en page possede des contreparties. Si Ton n'y prend gare, 
le risque existe d'aboutir a des programmes peu lisibles. A simple titre d'exemple, voici com- 
ment pourrait etre (mal) presente le programme du paragraphe 4 : 



1. Comme ::, = ;*()[]( } + -/<> & I. 

2. Sauf dans les constantes chaines telles que "Bonjour monsieur", ou les fins de ligne sont interdites. De telles 
constantes doivent imperativement etre ecrites sur une meme ligne. 
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II Calcul de racines carrees 

// La classe Racines utilise la classe Clavier 

public class Racines 1 { public 

static void main (Strincf ] 

args) { final int NEOIS = 5 ; int i ; double 
x ; double racx ; System. out. println ( 
"Bonj our" 

) ; System. out. println ("Je vais vous calculer " + 
NEDIS + " racines carrees") ; for (i=0 ; i 
<NEDIS ; i++) { System. out. print ("Donnez un nombre : ") ; x = 
Clavier. lireDouble () ; if (x < 0.0) System. out. println (x + 

" ne possede pas de racine carree") 
; else { racx = Math.sqrt(x) ; System. out. println ( 
x + " a pour racine carree : " + racx) ; } } System. out. println 
("Travail termine - Au revoir") ; }} 



Comme tout langage evolue, Java autorise la presence de commentaires dans les programmes 
source. Ces textes explicatifs destines aux lecteurs du programme n'ont aucune incidence sur 
sa compilation. 

Java dispose de deux formes de commentaires : 

• les commentaires usuels, 

• les commentaires de fin de ligne, 

5.5.1 Les commentaires usuels 

Ce sont ceux utilises en langage C. lis sont formes de caracteres quelconques places entre les 
caracteres /* et */. lis peuvent apparaitre a tout endroit du programme oil un espace est auto- 
rise. En general, cependant, on se limitera a des emplacements propices a une bonne lisibilite 
du programme. En voici quelques exemples : 

/* programme de calcul de racines carrees * / 

/* commentaire s' etendant 
sur plusieurs lignes 
de programme 

*/ 



Exemple de programme mal presente 



5.5 Les commentaires 



/* 



UN TITRE MIS EN VALEUR 



*/ 



int i ; 
float x; 
float racx 



/* compteur de boucle * / 

/* nombre dont on cherche la racine * / 

/* pour la racine carre de x * / 



5 - Regies generates d'ecriture 



5.5.2 Les commentaires de fin de ligne 

Ce sont ceux de C++. lis sont introduits par le double caractere //. Tout le texte suivant 
jusqu'a la fin de la ligne est considere comme un commentaire. Cette nouvelle possibilite 
n'apporte qu'un surcroit de confort et de securite. En effet, une ligne telle que : 

System. out. println ("bonjour) ; // formule de politesse 

peut toujours etre ecrite ainsi : 

System. out. println ("bonjour) ; /* formule de politesse */ 

Vous pouvez meler les deux formules. Notez que dans : 

/* partiel // partie2 * / partie3 

le commentaire ouvert par /* ne se termine qu'au prochain */ ; done partiel et partie2 sont 
des commentaires, tandis que partie3 est considere comme appartenant aux instructions. De 
meme, dans : 

partiel // partie2 /* partie3 */ partie4 

le commentaire introduit par // s'etend jusqu'a la fin de la ligne. II couvre done partiel, 
partiei et partie4. 

Remarque 

Si Ton utilise systematiquement le commentaire de fin de ligne, on peut alors faire appel 
a /* et */ pour inhiber un ensemble d' instructions (contenant eventuellement des com- 
mentaires) en phase de mise au point. 

Informations complementaires 

On dit souvent que Java possede une troisieme forme de commentaires dits de documen- 
tation. II s'agit en fait d'un cas particulier de commentaires usuels, puisqu'ils commen- 
cent par /** et qu'ils se terminent par */. Leur seul interet est de pouvoir etre extraits 
automatiquement par des programmes utilitaires de creation de documentation tels que 
Javadoc. 




5.6 Emploi du code Unicode dans le programme source 

La plupart des langages vous ont habitue a ecrire un programme en recourant a un nombre de 
caracteres relativement limite. La plupart du temps, vous disposez en effet des majuscules, 
des minuscules et des chiffres, mais pas necessairement des caracteres accentues. Ou bien 
vous pouvez saisir les caracteres accentues dans une implementation, mais ils apparaissent 
differemment dans une autre... Ces limitations proviennent de ce que, dans bon nombre de 
pays dont les pays occidentaux, les caracteres sont codes sur un seul octet. En outre, le code 
utilise n'est pas universel. II s'agit le plus souvent d'une variante locale du code ASCII inter- 
national a 7 bits (auquel n'appartiennent pas nos caracteres accentues). Par exemple, Win- 
dows utilise le code ASCII/ ANSI Latin 1. 
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Les concepteurs de Java ont cherche a attenuer ces limitations en utilisant le codage Unicode. 
Base sur 2 octets, il offre 65536 combinaisons qui permettent de representer la plupart des 
symboles utilises dans le monde 1 . Cependant, pour Finstant, vous devez toujours saisir votre 
programme avec un editeur generant des caracteres codes sur un octet. C'est pourquoi Java a 
prevu que, avant d'effectuer sa traduction, le compilateur commence par traduire votre fichier 
source en Unicode. 

Cette propriete aura des consequences interessantes dans le cas des constantes caracteres que 
nous etudierons au prochain chapitre. Si, dans une implementation donnee, vous parvenez a 
entrer un certain caractere (par exemple e), vous etes certain qu'il sera represente de facon 
portable dans les byte codes generes par le compilateur. Quant a votre programme source, il 
ne sera pas plus portable que celui d'un autre langage et sa traduction dans differents environ- 
nements pourra toujours conduire a certaines differences. 

En fait, Java a prevu une notation permettant d'introduire directement dans le source un des 
65536 caracteres Unicode. Ainsi, n'importe oil dans le source, vous pouvez utiliser la nota- 
tion suivante, dans laquelle xxxx represente 4 chiffres hexadecimaux : 



Cette notation designe simplement le caractere ayant comme code Unicode la valeur xxxx. 
Cette possibility pourra s'averer pratique pour introduire dans un programme une constante 
caractere n'existant pas dans 1' implementation ou se fait la saisie, mais dont on sait qu'elle 
existe dans F implementation ou le programme sera amene a s'executer. 

Informations complementaires 

Au paragraphe 5.1, nous avons donne quelques regies concernant l'ecriture des identifica- 
teurs et nous avons defini ce qu'on appelait une "lettre". En toute rigueur, de nombreux 
caracteres Unicode sont des lettres. C'est notamment le cas de tous nos caracteres accen- 
tues. S'ils existent dans 1' implementation ou vous saisissez votre programme source, rien 
ne vous empeche de declarer par exemple : 



Vous pouvez aussi utiliser la notation \uxxxx dans un identificateur. Mais cette possibi- 
lite peu lisible n'a guere d'interet : n'oubliez pas, en effet, que les symboles utilises 
pour ecrire un identificateur disparaissent apres compilation. 

D'autre part, depuis sa version JDK 5.0, Java permet d'utiliser un codage Unicode 
elargi. II faut alors distinguer le codage usuel dit BMP (Basic Multilingual Plan) qui 
utilise 16 bits (un char) d'une part, et le codage elargi qui quant a lui utilise 21 bits et 
necessite un int. 



\uxxxx 



int teteListe 



// correct 



1. Mais pas tous ! 



3 

Les types primitifs de Java 



Dans les chapitres precedents, nous avons rencontre les types int et double. Java dispose d'un 
certain nombre de types de base dits primitifs, permettant de manipuler des entiers, des flot- 
tants, des caracteres et des booleens. Ce sont les seuls types du langage qui ne sont pas des 
classes. Mais ils seront utilises pour definir les champs de donnees de toutes les classes que 
vous serez amenes a creer. 

Avant de les etudier en detail, nous effectuerons un bref rappel concernant la maniere dont 
1' information est representee dans un ordinateur et la notion de type qui en decoule. 

1 La notion de type 

La memoire centrale est un ensemble de "positions binaires" nominees bits. Les bits sont 
regroupes en octets (8 bits), et chaque octet est repere par ce qu'on nomme son adresse. 

Compte tenu de sa technologie (actuelle !), l'ordinateur ne sait representer et traiter que des 
informations exprimees sous forme binaire. Toute information, quelle que soit sa nature, 
devra etre codee sous cette forme. Dans ces conditions, on voit qu'il ne suffit pas de connaitre 
le contenu d'un emplacement de la memoire (d'un ou de plusieurs octets) pour pouvoir lui 
attribuer une signification. II faut egalement connaitre la maniere dont l'information qu'il 
contient a ete codee. II en va de meme en general pour traiter cette information. Par exemple, 
pour additionner deux valeurs, il faudra savoir quel codage a ete employe afin de pouvoir 
mettre en ceuvre les bonnes instructions 1 en langage machine. 



1 . Par exemple, on ne fait pas appel aux memes circuits electroniques pour additionner deux nombres codes sous 
forme entiere et deux nombres codes sous forme flottante. 
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D'une maniere generale, la notion de type, telle qu'elle existe dans les langages evolues, sert 
(entre autres choses) a regler les problemes que nous venons d'evoquer. 

Les types primitifs de Java se repartissent en quatre grandes categories selon la nature des 
informations qu'ils permettent de representer : 

• nombres entiers, 

• nombres flottants, 

• caracteres, 

• booleens. 

\^^~ Remarque 

Le JDK 5.0 a introduit la notion de type enumere que nous etudierons au chapitre 10. 
Nous verrons qu'il repose sur la notion de classe et qu'il ne constitue done pas un type 
primitif. 



2 Les types entiers 

lis servent a representer des nombres entiers relatifs. 

2.1 Representation memoire 

Un bit est reserve au signe (0 pour positif et 1 pour negatif). Les autres servent a representer : 

• la valeur absolue du nombre pour les positifs, 

• ce que Ton nomme le complement a deux du nombre, pour les negatifs. 

Examinons cela plus en detail, dans le cas de nombres represented sur 16 bits (ce qui corres- 
pondra finalement au type short de Java). 

2.1.1 Cas d'un nombre positif 

Sa valeur absolue est done ecrite en base 2, a la suite du bit de signe. Voici quelques exemples 
de codages de nombres. A gauche, le nombre en decimal ; au centre, le codage binaire 
correspondant ; a droite, le meme codage exprime en hexadecimal : 



1 0000000000000001 0001 

2 0000000000000010 0002 

3 0000000000000011 0003 
16 0000000000010000 00F0 

127 0000000001111111 007F 

255 0000000011111111 00FF 
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2.1.2 Cas d'un nombre negatif 

Sa valeur absolue est codee suivant ce que Ton nomme la technique du complement a deux. 
Pour ce faire, cette valeur est d'abord exprimee en base 2, puis tous les bits sont inverses (1 
devient 0 et 0 devient 1) ; enfin, on ajoute une unite au resultat. Voici quelques exemples 
(avec la meme presentation que precedemment) : 



-1 1111111111111111 FFFF 

-2 1111111111111110 FFFE 

-3 1111111111111101 FFFD 

-4 1111111111111100 FFFC 

-16 1111111111110000 FFF0 

-256 1111111100000000 FF00 



Remarques 

1 Le nombre 0 est code d'une seule maniere (0000000000000000). 

2 Si Ton ajoute 1 au plus grand nombre positif (ici 0111111111111111, soit 7FFF en 
hexadecimal ou 32768 en decimal) et que Ton ne tient pas compte de la derniere rete- 
nue (ou, ce qui revient au meme, si Ton ne considere que les 16 derniers bits du resul- 
tat), on obtient... le plus petit nombre negatif possible (ici 1111111111111111, soit 
FFFF en hexadecimal ou -32767 en decimal). C'est ce qui explique le phenomene de 
"modulo" bien connu de 1' arithmetique entiere, les depassements de capacite n'etant 
jamais signales, quel que soit le langage considere. 

2.2 Les differents types d'entiers 

Java dispose de quatre types entiers, correspondant chacun a des emplacements memoire de 
taille differente, done a des limitations differentes. Le tableau suivant en recapitule leurs 
caracteristiques. Notez F existence de constantes predefinies de la forme 
Integer.MAX_VALUE qui fournissent les differentes limites. 



Type 


Taille 
(octets) 


Valeur minimale 


Valeur maximale 


byte 


1 


-128 

(Byte.MIN_VALUE) 


127 

(Byte.MAX_VALUE) 


short 


2 


-32 768 

(Short.MII\l_VALUE) 


32 767 

(Short.MAX_VALUE) 


int 


4 


-2 147 483 648 
(lnteger.MIN_VALUE) 


2 147 483 647 
(lnteger.MAX_VALUE) 


long 


8 


-9 223 372 036 854 775 808 
(Long.MIN_VALUE) 


9 223 372 036 854 775 807 
(Long.MAX_VALUE) 



Les caracteristiques des quatre types entiers de Java 
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Q» E„C ++ 

On trouve trois types entiers short, int, long. Mais contrairement a ce qui se passe en Java, 
leur taille n'est pas entiere ment definie par le langage et peut done varier d'une imple- 
mentation a une autre. Par exemple, le type int peut etre code sur 2 octets sur une 
machine, 4 octets sur une autre... Le type byte n'existe pas en C++ (mais on peut utiliser 
le type signed char). 

2.3 Notation des constantes entieres 

La facon la plus naturelle d'introduire une constante entiere dans un programme est de 
l'ecrire sous forme decimale usuelle, avec ou sans signe, comme dans ces exemples : 

+5478 57 -278 

Mais on peut aussi utiliser une notation hexadecimale ou octale. Pour la notation hexade- 
cimale, on utilise les 10 chiffres (0 a 9), ainsi que les 6 lettres a, b, c, d, e et f (en majuscules 
ou en minuscules) ; on fait preceder la valeur de Ox ou OX. Par exemple : 

OxlA correspond a la valeur decimale 26 (16+10). 

Pour la notation octale, on fait preceder du chiffre 0 la valeur exprimee en base 8. Par 
exemple : 

014 correspond a la valeur decimale 12, 
037 correspond a la valeur decimale 3 1 . 

Une constante entiere est de l'un des types int ou long, suivant sa valeur. En principe, on peut 
penser que cet aspect a peu d' importance. Nous verrons cependant au chapitre 4 qu'il aura 
une legere incidence sur la validite de certaines expressions. 

On peut forcer une constante a etre du type long en faisant suivre sa valeur de la lettre / ou L, 
comme dans 25L (25 serait de type int). 

Le compilateur rejetera toute constante ayant une valeur superieure a la capacite du type long 
(dans certains autres langages, on pouvait obtenir une valeur erronee, sans en etre prevenu). 



3 Les types f lottants 

3.1 Les differents types et leur representation en memoire 

Les types flottants permettent de representee de maniere approchee, une partie des nombres 
reels. Pour ce faire, ils s'inspirent de la notation dite scientifique (ou exponentielle) bien con- 
nue qu'on trouve dans 1.5 10 22 ou 0.472 10~ 8 ; dans une telle notation, on nomme mantisses 
les quantites telles que 1.5 ou 0.472 et exposants les quantites telles que 22 ou -8. 
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Plus precisement, un nombre reel sera represents en flottant en determinant un signe 5 (+1 ou 
-1) et deux quantites M (mantisse) et E (exposant) telles que la valeur 

sM.2 E 

represente une approximation de ce nombre. 

Java prevoit deux types de flottants correspondant chacun a des emplacements memoire de 
tailles differentes : float et double. La connaissance des caracteristiques exactes du systeme 
de codage n'est generalement pas indispensable 1 . En revanche, il est important de noter que 
de telles representations sont caracterisees par deux elements : 

• la precision : lors du codage d'un nombre decimal quelconque dans un type flottant, il est 
necessaire de ne conserver qu'un nombre fini de bits. Or la plupart des nombres s'exprimant 
avec un nombre limite de decimales ne peuvent pas s'exprimer de facon exacte dans un tel 
codage. On est done oblige de se limiter a une representation approchee en faisant ce qu'on 
nomme une erreur de troncature. 

• le domaine convert, e'est-a-dire l'ensemble des nombres representables a l'erreur de tron- 
cature pres. 

Le tableau suivant recapitule les caracteristiques des types float et double. Notez ici encore 
l'existence de constantes predefinies de la forme Float.MAX_VALUE qui fournissent les dif- 
ferentes limites. 



Type 


Taille 

(octets 

) 


Precision 

(chiffres 

significatifs) 


Valeur absolue minimale 


Valeur absolue maximale 


float 


4 


7 


1.40239846E-45 
(Float. M I N_VALU E) 


3.40282347E38 
(Float.MAX_VALUE) 


dou- 
ble 


8 


15 


4.94065645841 24654E-324 
(Double.MIN_VALUE) 


1.7976931 3486231 6E308 
(Double.MAX_VALUE) 



Les caracteristiques des types flottants en Java 



Une estimation de l'erreur relative de troncature est fournie dans la colonne Precision sous la 
forme d'un nombre de chiffres significatifs. II s'agit d'une approximation decimale plus par- 
lante que son equivalent (exact) en nombre de bits significatifs. 

En C++ 

On trouve trois types flottants float, double et long double. Ici encore, contrairement a ce 
qui se passe en Java, leur taille, done a fortiori leurs caracteristiques dependent de 
1 ' implementation. 



1 . Sauf lorsque Ton doit faire une analyse fine des erreurs de calcul. 
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Remarque 

Java impose F utilisation des conventions IEEE 754 pour representer les nombres flot- 
tants. Cela implique qu'il existe des motifs binaires particuliers permettant de representer 
une valeur infinie (positive ou negative), ainsi qu'une valeur non representable (comme le 
resultat de la division de 0 par 0). Nous y reviendrons au chapitre suivant. D'autre part, il 
existe deux representations de zero (0+ et 0-) mais ce point n'a aucune incidence sur les 
calculs ou sur les comparaisons ; en particulier, ces deux valeurs sont bien strictement 
egales a O.f (float) ou 0. {double). 



3.2 Notation des constantes flottantes 

Comme dans la plupart des langages, les constantes flottantes peuvent s'ecrire indifferem- 
ment suivant Fune des deux notations : 

• decimale, 

• exponentielle. 

La notation decimale doit comporter obligatoirement un point (correspondant a notre vir- 
gule). La partie entiere ou la partie decimale peut etre omise (mais bien sur, il ne faut pas 
omettre les deux en meme temps !). En voici quelques exemples corrects : 

12.43 -0.38 -.38 4. .27 

En revanche, la constante 47 serait considered comme entiere et non comme flottante. En pra- 
tique, ce fait aura peu d'importance, compte tenu des conversions automatiques mises en 
place par le compilateur (et dont nous parlerons dans le chapitre suivant). 

La notation exponentielle utilise la lettre e (ou E) pour introduire un exposant entier (puis- 
sance de 10), avec ou sans signe. La mantisse peut etre n'importe quel nombre decimal ou 
entier (le point peut etre absent des que Ton utilise un exposant). Voici quelques exemples 
corrects (les exemples d'une meme ligne etant equivalents) : 

4.25E4 4.25e+4 42.5E3 

54.27E-32 542.7E-33 5427e-34 

48el3 48.el3 48.0E13 

Par defaut, toutes les constantes sont creees par le compilateur dans le type double. Cela 
implique qu'une simple affectation telle que la suivante pose probleme : 
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float x ; 



x = 12.5 ; // erreur de compilation : on ne peut pas convertir 
// implicitement de double en float 
II est toutefois possible d'imposer a une constante flottante d'etre du type float, en faisant sui- 
vre son ecriture de la lettre F (ou f). Cela permet de gagner un peu de place en memoire, en 
contrepartie d'une eventuelle perte de precision. On peut aussi regler le probleme evoque ci- 
dessus, en procedant ainsi : 

float x ; 



x = 12. 5f ; // cette fois, 12. 5f est bien de type float 



4 Le type caractere 

4.1 Generalites 

Comme la plupart des langages, Java permet de manipuler des caracteres. Mais il offre l'ori- 
ginalite de les representer en memoire sur deux octets en utilisant le code universel Unicode 
dont nous avons parle au chapitre precedent. 

Parmi les 65536 combinaisons qu' offre Unicode, on retrouve les 128 possibilites du code 
ASCII restreint (7 bits) et meme les 256 possibilites du code ASCII/ANSI (Latin 1) utilise 
par Windows. Celles-ci s'obtiennent simplement en completant le code ASCII par un un pre- 
mier octet nul. Cela signifie done qu'en Java comme dans les autres langages, la notion de 
caractere depasse celle de caractere imprimable, e'est-a-dire auquel on peut associer un gra- 
phisme. 

Une variable de type caractere se declare en utilisant le mot-cle char comme dans : 

char cl, c2 ; // cl et c2 sont deux variables de type caractere 

4.2 Ecriture des constantes de type caractere 

On peut noter une constante caractere de facon classique entre apostrophes, par exemple : 

'a' ' E' ' e' ' +' 

Bien entendu, cette notation n'est utilisable que si le caractere est disponible dans l'imple- 
mentation considered, qu'il dispose d'un graphisme et d'une combinaison de touche permet- 
tant de le saisir avec un editeur 1 . 



1 . Rappelons que tous les caracteres de votre programme source (y compris ceux places entre apostrophes) sont 
codes sur un octet lors de la saisie ; ce n'est qu'avant la compilation qu'ils sont convertis en Unicode. 
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Certains caracteres ne disposant pas de graphisme possedent une notation conventionnelle 
utilisant le caractere V ; dans cette categorie, on trouve egalement quelques caracteres qui, 
bien que disposant d'un graphisme, jouent un role particulier de delimiteur qui leur interdit la 
notation classique. En voici la liste : 



Notation 


code Unicode 


Abreviation usuelle 


Signification 




(hexadecimal) 




\b 


0008 


BS (Backspace) 


Retour arriere 


\t 


0009 


HT (Horizontal tabulation) 


Tabulation horizon- 


\n 


000a 


LF (Line feed) 


tale 


\f 


000c 


FF (Form feed) 


Saut de ligne 


\r 


OOOd 


CR (Cariage return) 


Saut de page 


V 


0022 


Retour chariot 


V 


0027 






w 


005c 







Les caracteres disposant d'une notation speciale 



De plus, on peut definir une constante caractere en fournissant directement son code en hexa- 
decimal sous la forme suivante, deja rencontree au paragraphe 5.6 du chapitre 2 : 

\uxxxx 

Rappelons en effet que vous saisissez votre programme source avec un editeur local codant 
les caracteres sur un octet. Le jeu de caracteres d'une implementation donnee est done tres 
limite. Le merite de la notation precedente est de vous permettre d'entrer le code d'un carac- 
tere inconnu de votre editeur. Bien entendu, cela ne prejuge nullement de l'usage qu'en fera 
le programme par la suite 2 . 

Remarques 

1 Les constantes caractere ayant un code compris entre 0 et 255 peuvent etre exprimees en 
octal sous la forme suivante, dans laquelle ooo represented un nombre a trois chiffres en 
base 8 (0 a 7) : 

' \ ood 



1. Ne pas confondre cette instruction avec celle employee pour introduire un caractere par son code Unicode. 

2. Par exemple, si le programme affiche un tel caractere a l'ecran, celui-ci sera a nouveau converti d'Unicode 
dans le codage local (sur un octet) de la machine d'execution (qui n'est pas necessairement celle ou s'est faite 
la saisie). Si la conversion n'est pas possible, on obtiendra simplement l'affichage d'un point d' interrogation. 
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2 Dans un programme source, distinguez bien les caracteres qui disparaitront apres com- 
pilation (comme ceux qui interviennent dans un identificateur) de ceux qui subsisteront 
(comme ceux qui apparaissent dans une constante caractere). 

Informations complementaires 

Si vous souhaitez voir comment certains des 65536 caracteres Unicode s'affichent dans 
votre implementation, vous pouvez adapter le programme suivant. Ce dernier affiche tous 
les caracteres dont le code est compris entre codeDeb et codeFin. Sachez que lorsqu'un 
caractere n'est pas connu de 1' implementation, il doit s'afficher sous la forme d'un point 
d' interrogation. Notez que ce programme fait intervenir des aspects qui ne seront exposes 
que plus tard (conversions de char en int, utilisation d'un entier pour initialiser une varia- 
ble de type char). 

public class TestUni 

{ static void main (String! ] args) 

{ final char carDeb = 200, carFin = 300 ; 
char c ; 

for (c=carDeb ; c<carFin ; C++) 

{ System. out. print ((int)c + "-") ; 
System. out. print (c + " ") ; 



200-+ 201-+ 202-- 203-- 204-1 205-- 206-+ 207-- 208-- 209-- 210-- 211-+ 212-+ 21 
3-+ 214-+ 215-+ 216-+ 217-+ 218-+ 219-_ 220-_ 221-1 222-_ 223-_ 224-_ 225-15 226- 
_ 227-1 228-_ 229-_ 230-u 231-_ 232-_ 233-_ 234-_ 235-_ 236-_ 237-_ 238-_ 239-_ 
240-_ 241-+ 242-_ 243-_ 244-_ 245-_ 246-+- 247-_ 248-" 249-' 250- ■ 251-_ 252-n 25 
3- 2 254-_ 255-_ 256-? 257-? 258-? 259-? 260-? 261-? 262-? 263-? 264-? 265-? 266- 
? 267-? 268-? 269-? 270-? 271-? 272-? 273-? 274-? 275-? 276-? 277-? 278-? 279-? 
280-? 281-? 282-? 283-? 284-? 285-? 286-? 287-? 288-? 289-? 290-? 291-? 292-? 29 
3-? 294-? 295-? 296-? 297-? 298-? 299-? 



Affichage des caracteres de codes donnes 



En C++ 

C++ represente les caracteres sur un seul octet en utilisant un code dependant de F imple- 
mentation. En outre, il existe une equivalence entre octet et caractere sur laquelle 
s'appuient bon nombre de programmes. 
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5 Le type booleen 

Ce type sert a representer une valeur logique du type vrai/faux. II n'existe pas dans tous les 
langages car il n'est pas aussi indispensable que les autres. En effet, on peut souvent se con- 
tenter d' expressions booleennes du genre de celles qu'on utilise dans une instruction if: 

if (rKp) // n<p est une expression booleenne valant vrai ou faux 

En Java, on peut disposer de variables de ce type, ce qui permettra des affectations telles que : 

boolean ordonne ; // declaration d' une variable de type booleen 

ordonne = n<p ; // ordonne recoit la valeur de 1' expression booleenne n<p 

Les deux constantes du type booleen se notent true et false. 



6 Initialisation et constantes 

6.1 Initialisation d'une variable 

Une variable peut recevoir une valeur initiale au moment de sa declaration, comme dans : 

int n = 15 ; 

Cette instruction joue le me me role que : 

int n ; 
n = 15 ; 

Rien n'empeche que la valeur de n n'evolue par la suite. 

Comme en Java les declarations peuvent apparaitre a n'importe quel emplacement du pro- 
gramme, on ne peut plus les distinguer completement des instructions executables. En parti - 
culier, on peut initialiser une variable avec une expression autre qu'une constante. Voici un 
exemple : 

int n = 10 ; 

int p = 2*n // OK : p recoit la valeur 20 (si la valeur de n if a pas 

// change depuis son initialisation) 

Un autre exemple : 

int n ; 

n = Clavier. lirelnt () ; 

int p = 2 * n ; // OK - la valeur initiale de p ne sera toutefois 

// connue qu' au moment de 1' execution 
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6.2 Cas des variables non initialisees 

En Java, une variable n'ayant pas encore recu de valeur ne peut pas etre utilisee, sous peine 
d'aboutir a une erreur de compilation. En voici deux exemples : 

int n ; 

System. out. println ("n = " + n ) ; // erreur de compilation : la valeur 

// de n n' est pas definie ici 

int n ; 

int p = n+3 ; // erreur de compilation : la valeur de n n' est pas encore define 
n = 12 ; // elle 1' est ici (trop tard) 

Contrairement a la plupart des autres langages, Java est capable de detecter toutes les situa- 
tions de variables non initialisees, comme le montre cet exemple : 

int n ; 

if (...) n = 30 ; 

p = 2*n ; // erreur de compilation : n n' est pas initialisee dans tous les cas 

Ici, le compilateur s'est apercu de ce que la variable n pouvait ne pas recevoir de valeur dans 
certains cas. En revanche, les instructions suivantes seront acceptees : 

int n ; 

if (...) n = 30 ; 

else n = 10 ; 

p = 2*n ; // OK : n a obligatoirement recu 1' une des valeurs 30 ou 10 

Informations complementaires 

Nous verrons que ce que nous nommons pour l'instant variable est en fait une variable 
locale a la methode main. Nous rencontrerons d' autres sortes de variables, en particulier 
les champs des objets. Contrairement aux variables locales evoquees ici, ces champs 
seront soumis a une initialisation implicite par defaut ; le risque de champ non defini 
n'existera done pas. D'autre part, nous verrons qu'il existe des variables ou des champs 
d'un type autre que primitif, a savoir objet ou tableau. 

6.3 Constantes et expressions constantes 
6.3.1 Le mot-cle final 

Java permet de declarer que la valeur d'une variable ne doit pas etre modifiee pendant l'exe- 
cution du programme. Par exemple, avec : 

final int n = 20 ; 

on declare la variable n de type int, de valeur initiale 20. De plus, toute tentative ulterieure de 
modification de la valeur de n sera rejetee par le compilateur : 

n = n + 5 ; // erreur : n a ete declaree final 

n = Clavier. lirelnt () ; // idem 
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D'une maniere generate, le mot-cle final peut etre utilise quelle que soit l'expression d'initili- 
sation de la variable : 

int p ; 



p = Clavier . lirelnt () ; 

final int n=2*p; // OK, bien que la valeur de n ne soit connue 

// qu' a 1' execution 

n++ ; // erreur de compilation : n est declaree final 

6.3.2 Notion d'expression constante 

Les deux expressions utilisees pour initialiser les variables n de nos deux exemples prece- 
dents sont de nature differente. Dans le premier cas, il s'agit de la valeur 20, bien definie et 
connue des la compilation. Dans le second cas, il s'agit d'une expression (2*p) dont la valeur, 
connue qu'a l'execution, peut differer d'une execution a l'autre. 

Vous constatez que final ne fait pas la distinction. On ne peut done pas dire que final sert a 
declarer ce que Ton nomme des constantes symboliques dans certains autres langages. En 
fait, final demande simplement que la valeur d'une variable n'evolue plus apres avoir ete 
fixee (nous verrons qu'il n'est meme pas necessaire que cette premiere valeur soit definie 
dans la declaration). 

En revanche, nous rencontrerons des situations oil il est nessaire de distinguer les deux sortes 
d' expressions. On parlera d' expression constante pour designer une expression calculable par 
le compilateur. 

Lorsque final est utilise conjointement avec une expression constante, on retrouve la notion 
usuelle de definition de constante symbolique, autrement dit d'un symbole dont la valeur est 
parfaitement connue du compilateur. En Java, il est d' usage d'ecrire les constantes symboli- 
ques en majuscules : 

final int NDMBRE = 20 ; 



final int LIMITE = 2 * NDMBRE + 3 ; 

|J|fr En C++ 

En C++, on peut declarer des constantes symboliques a l'aide du mot-cle const. Les 
valeurs correspondantes doivent obligatoirement etre des expressions constantes. En 
revanche, la protection contre la modification accidentelle de telles valeurs est beaucoup 
moins efficace qu'en Java. 

6.3.3 L'initialisation d'une variable final peut etre differee 

En theorie, vous n'etes pas oblige d' initialiser une variable declaree final lors de sa 
declaration. En effet, Java demande simplement qu'une variable declaree final ne recoive 
qu'une seule fois une valeur. Voyez ces exemples : 
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final int n ; // OK, meme si n n' a pas (encore) recu de valeur 

n = Clavier. lirelnt () ; // premiere affectation de n : OK 

n++ ; // nouvelle affectation de n : erreur de compilation 

final int n ; 

if (...) n = 10 ; //OK 
else n = 20 

Cependant, nous ne recommandons de recourir le moins possible a une telle demarche qui 
nuit fortement a la lisibilite des programmes et de toujours chercher a initialiser une variable 
le plus pres possible de l'endroit ou elle est definie. 



4 



Les operateurs 
et les expressions 



Java est Fun des langages les plus fournis en operateurs. II dispose en effet des operateurs 
classiques (arithtnetiques, relationnels, logiques) ou moins classiques {manipulations de 
bits), mais aussi d'un important eventail d'operateurs originaux d 'affectation et d'incremen- 
tation. Nous verrons en effet que ces actions sont realisees par des operateurs. 

Ce chapitre etudie tous les operateurs de Java, ainsi que les regies de priorite et de conversion 
de type qui interviennent dans les evaluations des expressions. 

1 Originalite des notions d'operateur 
et d'expression 

Dans la plupart des langages, on trouve, comme en Java : 

• des expressions formees (entre autres) a l'aide d'operateurs, 

• des instructions pouvant eventuellement faire intervenir des expressions, comme Finstruc- 
tion d' affectation : 

y = a * x + b ; 

Mais generalement, dans les langages autres que Java (ou C++), F expression possede une 
valeur mais ne realise aucune action, en particulier aucune affectation d'une valeur a une 
variable. Au contraire, Faffectation y realise une affectation d'une valeur a une variable mais 
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ne possede pas de valeur. Les notions de valeur et d' action sont parfaitement disjointes. En 
Java, il en va differemment puisque : 

• les (nouveaux) operateurs d' incrementation pourront non seulement intervenir au sein d'une 
expression (laquelle, au bout du compte, possedera une valeur), mais aussi agir sur le con- 
tenu de variables. Ainsi, l'expression (comme nous le verrons, il s'agit bien d'une expres- 
sion en Java) : 

++i 

realisera une action, a savoir augmenter la valeur de i de 1 ; en meme temps, elle aura une 
valeur, celle de i apres incrementation. 

• une affectation apparemment classique telle que : 

i = 5 

pourra, a son tour, etre considered comme une expression (ici, de valeur 5). D'ailleurs, en 
Java, 1' affectation (=) est un operateur. Par exemple, la notation suivante : 

k = i = 5 

represente une expression (ce n'est pas encore une instruction - nous y reviendrons). Elle 
sera interpretee comme : 

k = (i = 5) 

Autrement dit, elle affectera a i la valeur 5 puis elle affectera a A: la valeur de l'expression ; 
= 5, c'est-a-dire 5. 

En fait, en Java, les notions d'expression et d'instruction sont etroitement liees puisque la 
principale instruction de ce langage est... une expression terminee par un point- virgule. On la 
nomme souvent instruction expression. Voici des exemples de telles instructions qui repren- 
nent les expressions prededentes : 

++i ; 
i = 5 ; 
k = i = 5 ; 

Les deux premieres ont Failure d'une affectation telle qu'on la rencontre classiquement dans 
la plupart des autres langages. Notez que, dans les deux cas, il y a evaluation d'une expres- 
sion (++; ou i=5) dont la valeur est finalement inutilisee. Dans le dernier cas, la valeur de 
l'expression i=5, c'est-a-dire 5, est a son tour affectee a k ; par contre, la valeur finale de 
l'expression complete est, la encore, inutilisee. 

Remarque 

Un appel de fonction (methode) est aussi une expression. S'il est suivi d'un point-virgule, 
cela devient une instruction expression : si la methode fournit une valeur, elle est alors 
ignoree. Examinons ces exemples : 
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Clavier . lirelnt ( ) 
Math.sqrt(5) ; 



// lit une valeur au clavier, sans 1' utiliser 
//OK mais sans interet 



Lorsqu'une methode ne fournit pas de valeur, on ne peut pas l'utiliser dans une expres- 
sion, mais on peut toujours 1' employer dans une instruction expression. C'est ce que 
Ton fait couramment dans : 

System. out .println ("bonjour") ; 



Comme tous les langages, Java dispose d'operateurs classiques binaires (c'est-a-dire portant 
sur deux operandes), a savoir F addition (+), la soustraction (-), la multiplication (*) et la divi- 
sion (/), ainsi que de deux operateurs unaires (c'est-a-dire ne portant que sur un seul ope- 
rande) correspondant a F oppose note - (comme dans -n ou dans -x+y) et a Fidentite note + 
(comme dans +a ou dans +(b-a)). 

Les operateurs binaires ne sont a priori definis que pour deux operandes ayant le meme type 1 
parmi int, long, float ou double et ils fournissent un resultat de meme type que leurs operan- 
des. Mais nous verrons au paragraphe 3 que par le jeu des conversions implicites, le compila- 
teur saura leur donner une signification lorsqu'ils porteront : 

• soit sur des operandes de types differents, 

• soit sur des operandes de type byte, char ou short. 

De plus, il existe un operateur de modulo note % qui peut porter sur des entiers ou sur des 
flottants. Avec des entiers, il fournit le reste de la division entiere de son premier operande 
par son second. Par exemple : 

11%4 vaut3, 

23%6 vaut 5, 

-11%3 vaut -2, 

-ll%-3 vaut -2 

Avec des flottants, il fonctionne de maniere similaire 2 : 

12.5%3.5 vaut environ 3, 

-15.2%7.5 vaut environ -0.2. 



1. En machine, il n' existe, par exemple, que des additions de deux entiers de meme taille ou de flottants de 
meme taille. II n'existe pas d'addition d'un entier et d'un flottant ou de deux flottants de taille differente. 

2. Mais peu de langages disposent d'un operateur modulo pour les flottants. 



2 Les operateurs arithmetiques 



2.1 Presentation des operateurs 
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Notez bien qu'en Java, le quotient de deux entiers fournit un entier. Ainsi 5/2 vaut 2 ; en 
revanche, le quotient de deux flottants (note lui aussi I) est bien un flottant (5.0/2.0 vaut bien 
approximativement 2.5). 



II n'existe pas d'operateur d' elevation a la puissance. II faut faire appel soit a des produits 
successifs pour des puissances entieres pas trop grandes (par exemple, on calculera x 3 
comme x*x*x), soit a la fonction Math.pow 1 . 



En C/C++, Foperateur % n'est parfaitement defini que pour des entiers positifs ; il ne peut 
pas porter sur des flottants. 



Lorsque plusieurs operateurs apparaissent dans une meme expression, il est necessaire de 
savoir dans quel ordre ils sont mis en jeu. En Java comme dans les autres langages, les regies 
sont celles de Falgebre traditionnelle (du moins en ce qui concerne les operateurs arithmeti- 
ques dont nous parlons ici). 

Les operateurs unaires + et - ont la priorite la plus elevee. On trouve ensuite, a un meme 
niveau, les operateurs *, / et %. Au dernier niveau, apparaissent les operateurs binaires + et -. 

En cas de priorites identiques, les calculs s'effectuent de gauche a droite. On dit que Ton a 
affaire a une associativite de gauche a droite 2 . 

Des parentheses permettent d'outrepasser ces regies de priorite, en forcant le calcul prealable 
de 1' expression qu'elles contiennent. Notez qu'elles peuvent egalement etre employees pour 
assurer une meilleure lisibilite d'une expression. 

Voici quelques exemples dans lesquels l'expression de droite, ou ont ete introduites des 
parentheses superflues, montre dans quel ordre s'effectuent les calculs (les deux expressions 
proposees conduisent done aux memes resultats) : 





Remarque 



j[3[f En C++ 



2.2 Les priorites relatives des operateurs 



a 



a + b * c 



b + c 



d 



a + ( b * c ) 

( a * b ) + ( c % d ) 



- a + c % d 

- a / - b + c 

- a / - ( b + c ) 



- c 



d 



- c ) % d 

- a ) + ( c % d ) 
(-a)/(-b))+c 
-a)/(-(b + c)) 



1 . En toute rigueur, il s'agit de la fonction statique pow de la classe Math (de meme que System.println designe 
la fonction statique println de la classe System). 

2. Nous verrons que quelques operateurs (non arithmetiques) utilisent une associativite de droite a gauche. 
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2.3 Comportement en cas d'exception 

Comme dans tous les langages, il existe des circonstances oil un operateur ne peut pas fournir 
un resultat correct, soit parce que le type utilise ne permet pas de le representee soit parce 
que le calcul est tout simplement impossible. On parle dans ce cas de situation d'exception 1 . 

2.3.1 Cas des entiers 

Comme nous l'avons deja signale, le depassement de capacite n'est jamais detecte. On se 
contente de conserver les bits les moins significatifs du resultat. Nous en avons rencontre 
quelques exemples. 

En revanche, la division par zero (par / ou par %) conduit a une erreur d' execution. Plus pre- 
cisement, il y a declenchement de ce que Ton nomme une exception de type ArithmecticEx- 
ception. Nous apprendrons au chapitre 10 qu'il est possible d'intercepter une telle exception. 
Si nous le faisons pas, nous aboutissons simplement a F arret de l'execution du programme, 
avec un message de ce type en fenetre console : 

Exception in thread "main" java. lang.ArithmeticException: / by zero 
at Test. main (Test. java: 9) 

2.3.2 Cas des f lottants 

En Java, aucune operation sur les flottants ne conduit a un arret de l'execution (pas meme une 
division par zero !). En effet, comme nous l'avons dit, les flottants sont codes en respectant 
les conventions IEEE 754. Celles-ci imposent qu'il existe un motif particulier pour represen- 
ter l'infini positif, l'infini negatif et une valeur non calculable. En Java, ces valeurs peuvent 
meme etre affichees ou affectees directement a des variables. Examinons ce petit exemple : 

public class IEEE 

{ public static void main (String args[ ] ) 
{ float x = le30f ; 
float y ; 
y = x*x ; 

System. out. println (x + " a pour carre : " + y) ; 

float zero = O.f ; // division flottante par zero 

float z = y/zero ; 

System. out. println (y + " divise par 0 = " + z) ; 
y = 15 ; 

System . out . println (y + " divise par 0 = " + z) ; 



1. Ce terme doit etre distingue de celui utilise dans la "gestion des exceptions", meme si, dans certains cas, il y 
a bien un lien entre les deux notions. 



Les operateurs et les expressions 

Chapitre 4 



float xl = Float. POSITIVE_INFINITY ; // tinfini 
float x2 = Float. NEGAT±VE_INFINITY ; // -infini 
z = xl/x2 ; 

System. out .println (xl + "/" + x2 + " = " + z) ; 

} 

) 

1 . 0E30 a pour carre : Infinity 
Infinity divise par 0 = Infinity 
15 . 0 divise par 0 = Infinity 
Infinity/-Infinity = NaN 

Exemple d' exploitation des conventions IEEE 754 

Comme vous le constatez, les trois motifs dont nous avons parle provoquent l'affichage de 
Infinity, -Infinity et NaN (abreviation de Not a Number). Les constantes correspondantes se 
nomment Float.POSITIVEJNFINITY (Double.POSITIVEJNFINITY pour le type double), 
Float.NEGATIVEJNFINITY (Double.NEGATIVEJNFINITY) et Float.NaN (Double.NaN). 

JJf En C++ 

En C/C++, le comportement en cas d' exception depend de F implementation. 

3 Les conversions implicites 
dans les expressions 

3.1 Notion d'expression mixte 

Comme nous F avons dit, les operateurs arithmetiques ne sont de finis que lorsque leurs deux 
operandes sont de meme type. Mais vous pouvez ecrire des expressions mixtes dans lesquel- 
les interviennent des operandes de types differents. Voici un exemple d'expression correcte, 
dans laquelle n et p sont supposees etre de type int, tandis que x est supposee etre de type 
float : 

n * x + p 

Dans ce cas, le compilateur sait, compte tenu des regies de priorite, qu'il doit d'abord effec- 
tuer le produit n*x. Pour que ce soit possible, il va mettre en place des instructions 1 de con- 
version de la valeur de n dans le type float (car on considere que ce type float permet de 



1 . Attention, le compilateur ne peut que prevoir les instructions de conversion (qui seront done executees en 
meme temps que les autres instructions du programme) ; il ne peut pas effectuer lui-meme la conversion d'une 
valeur que generalement il ne peut pas connaitre. 
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representer a peu pres convenablement une valeur entiere, 1' inverse etant nature llement faux). 
Au bout du compte, la multiplication portera sur deux operandes de type float et elle fournira 
un resultat de type float. 

Pour F addition, on se retrouve a nouveau en presence de deux operandes de types differents 
(float et int). Le meme mecanisme sera mis en place, et le resultat final sera de type^oaf. 

3.2 Les conversions d'ajustement de type 

Une conversion telle que int -> float se nomme une conversion d'ajustement de type. Elle ne 
peut se faire que suivant une hierarchie qui permet de ne pas denaturer la valeur initiale 1 , a 
s avoir : 

int -> long -> float -> double 

On peut bien sur convertir directement un int en double ; en revanche, on ne pourra pas con- 
vertir un double en float ou en int. 

Notez que le choix des conversions a mettre en ceuvre est effectue en considerant un a un les 
operandes concernes et non pas l'expression de facon globale. Par exemple, si n est de type 
int, p de type long et x de type float, l'expression : 

n * p + x 

sera evaluee suivant ce schema : 

n * p + x 
I 

long 

I 

long 
I 

float 
I 

I + 

I 

float ce qui fournit un resultat de type float 

3.3 Les promotions numeriques 

Les conversions d'ajustement de type ne suffisent pas a regler tous les cas. En effet, comme 
nous l'avons deja dit, les operateurs numeriques ne sont pas definis pour les types byte, char 
et short. 

En fait, Java prevoit tout simplement que toute valeur de Fun de ces deux types apparaissant 
dans une expression est d'abord convertie en int, et cela sans considerer les types des even- 



conversion de n en long 

multiplication par p 

le resultat de * est de type long 

il est converti en float 

pour etre additionne a x 



1 . On dit parfois que de telles conversions respectent 1' integrite des donnees. 
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tuels autres operandes. On parle alors de promotions numeriques (ou encore de conversions 
systematiques). 

Par exemple, si pi, p2 et p3 sont de type short et x de type float, 1' expression : 

pi * p2 + p3 * x 
est evaluee comme Findique ce schema : 

p2 + p3 * x 



Pi 
I 

int 



int 
I 

float 



float 



float 



promotions numeriques short -> int 
multiplication 

conversion d ajustement de type 
addition 

conversion df ajustement de type 



float 

Notez bien que les valeurs des trois variables de type short sont d'abord soumises a la promo- 
tion numerique short -> int ; ensuite, on applique les memes regies que precedemment. 

3.4 Consequences des regies de conversion 

La mise en place de conversions automatiques conduit parfois a des situations inattendues, 
comme le montre ce petit exemple : 

public class Conver 

{ public static void main (String args[ ] ) 
{ byte bl = 50, b2 = 100 ; 
int n ; 

n = bl * b2 ; // bl et b2 sont convertis en int, avant qu' on en fasse le 
// produit (en int) ; le resultat aurait depasse la capacite 
// du type byte, mais il est correct 1 

System. out. println (bl + "*" + b2 + " = " + n) ; 

int nl = 100000, n2 = 200000 ; 

long p ; 

p = nl*n2 ; // le produit est calcule en int, il conduit a un depassement 

// le resultat (errone) est affecte a p 
System. out. println (nl + "*" + n2 + " = " + p) ; 



} 



1. En revanche, on verra plus loin qu'un probleme se poserait si Ton voulait affecter ce resultat a une variable 
de type byte. 
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50*100 = 5000 

100000*200000 = -1474836480 



Consequences des regies de conversion 



Si, dans la premiere affectation (n = bl*b2), l'expression bl*b2 avait ete calculee dans le 
type byte, sa valeur n'aurait pas ete representable. Mais, compte tenu des regies de promo- 
tions numeriques, elle a ete calculee dans le type int. 

En revanche, dans la seconde affectation (p = nl *n2), l'expression nl *n2 est calculee dans le 
type int (le type de p n'ayant aucune influence sur le calcul a ce niveau). Le resultat theorique 
depasse la capacite du type int ; dans ce cas, comme dans la plupart des langages, Java n'en 
conserve que les bits les moins significatifs, ce qui fournit un resultat faux ; c'est ce dernier 
qui est ensuite converti en long. 



En Java, une variable de type caractere peut intervenir dans une expression arithmetique car il 
est prevu une promotion numerique de char en int. A priori, vous pouvez vous interroger sur 
la signification d'une telle conversion. En fait, il ne s'agit que d'une question de point de vue. 
En effet, une valeur de type caractere peut etre consideree de deux facons : 

• comme le caractere concerne : a, Z, fin de ligne..., 

• comme le code de ce caractere, c'est-a-dire un motif de 16 bits ; or a ce dernier on peut tou- 
jours faire correspondre un nombre entier, a savoir le nombre qui, code en binaire, fournit 
le motif en question ; par exemple, en Java qui utilise Unicode, le caractere E est represente 
par le motif binaire 00000000 01000101, auquel on peut faire correspondre le nombre 69. 

Voici quelques exemples d' evaluation d' expressions, dans lesquels on suppose que cl et c2 
sont de type char, tandis que n est de type int. 



3.5 Le cas du type char 



Exemple 1 



cl 



+ 



1 



int 



promotion numerique char -> int 



+ 



int 

L'expression cl+1 fournit done un resultat de type int, correspondant a la valeur du code du 
caractere contenu dans cl augmente d'une unite. 
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Exemple 2 



cl 



c2 



int 



int 



promotions numeriques char -> int 



int 



Ici, bien que les deux operandes soient de type char, il y a quand meme conversion prealable 
de leurs valeurs en int (promotions numeriques). Avec cl = 'E' et c2 = 'A', l'expression cl- 
c2 vaudra 4 1 . 



1 La conversion de char (16 bits) en int (32 bits) se fait en completant le motif binaire ini- 
tial par 16 bits a zero. On ne tient pas compte d'un eventuel bit de signe (comme ce serait 
le cas en C). Autrement dit, les valeurs entieres ainsi obtenues sont comprises dans 
l'intervalle 0 a 65 535 et non dans Fintervalle -32768 a 32767. 

2 Ici, nous nous limitons a des expressions faisant intervenir des caracteres, sans prejuger 
de l'usage qui en est fait. Or, autant on n'a aucune raison de vouloir employer cl*c2 
comme une valeur de type caractere, autant on sera tente de le faire pour cl+1, ne 
serait-ce qu'en ecrivant c2 = cl+1. Nous verrons plus loin qu'une telle affectation ne 
pourra se faire qu'en indiquant explicitement la conversion de cl+1 en char, en 
ecrivant : 



Comme tout langage, Java permet de comparer des expressions a l'aide d' operateurs classi- 
ques de comparaison. En voici un exemple : 

2 * a>b + 5 

Le resultat est une valeur booleenne ayant Fune des deux valeurs true ou false. On pourra : 
• l'utiliser dans une instruction if, comme dans : 

if (2 * a > b + 5) ... 



> 



Remarques 



cl = (char (cl+1) ) 



4 



Les operateurs relationnels 



4.1 Presentation generale 



1. En Unicode, comme en ASCII, les codes des lettres majuscules sont consecutifs. 
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• l'affecter a une variable booleenne : 

boolean ok ; 



ok = 2* a>b + 5 

• le faire intervenir dans une expression booleenne plus complexe. 

Comme les operateurs arithmetiques, les operateurs relationnels ne sont theoriquement 
definis que pour des operandes de meme type, parmi int, long, float ou double. Mais ils sou- 
mettent eux aussi leurs operandes aux conversions implicites (promotions numeriques et 
ajustement de type), de sorte qu'au bout du compte ils pourront porter sur des operandes de 
types quelconques, y compris byte, short ou char. 

Voici la liste des operateurs relationnels existant en Java. Remarquez bien la notation (==) de 
l'operateur d'egalite, le signe = etant reserve aux affectations : 



Operateur 


Signification 


< 


inferieur a 


<= 


inferieur ou egal a 


> 


superieur a 


>= 


superieur ou egal a 




egal a 


l= 


different de 



Les operateurs relationnels 



II faut savoir que les quatre premiers operateurs (<, <=, >, >=) sont de meme priorite. Les 
deux derniers (== et !=) possedent egalement la meme priorite, mais celle-ci est inferieure a 
celle des precedents. D' autre part, ces operateurs relationnels sont moins prioritaires que les 
operateurs arithmetiques. Cela permet souvent d'eviter certaines parentheses dans des 
expressions. 

Ainsi : 

x + y < a + 2 
est equivalent a : 

(x+y)<(a+2) 

Of En C++ 

En C++, il n'existe pas d' expressions booleennes (mais on y trouve des variables 
booleennes !). C++ dispose des memes operateurs de comparaison qu'en Java, mais ils 
fournissent un resultat de type entier (0 ou 1). 
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Chapitre 4 



4.2 Cas particulier des valeurs Infinity et NaN 

Nous avons vu au paragraphe 2.3.2 que Java represente les valeurs flottantes en respectant les 
conventions IEEE 754 qui imposent l'existence de motifs particuliers tels que 
Float.POSITIVE_INFINITY, Float. NEGA TIVE_INFINITY, Float.NaN... 

Comme on peut s'y attendre, les valeurs representant rinfini sont comparables a n'importe 
quelles valeurs de type fiottant. Par exemple, Float.POSITIVE_INFINITY est superieure a 
toute valeur finie de type float ou double : 

double x = 5e20 ; 

if (x < Double. POSITIVE_INFINITY) ... // vrai 

if (x < Float. K)SITIvE_INFINITY) ... // vrai car Float. POSITIVE_INFINITY est 

// convertie en double, ce qui fournit Double. POSITIvE_INFINITY 

En revanche, la comparaison de NaN avec une autre valeur fournit toujours un resultat faux. 
Par exemple, considerez : 

float x ; 

x = Float.NaN ; 

y = 2 ; 

if (x<y) ... // faux 
if (y<=x) ... // faux 

La relation x<y est fausse, mais la relation y<=x Test aussi ! 

4.3 Cas des caracteres 

Compte tenu des regies de conversion, une comparaison peut porter sur deux caracteres. Bien 
entendu, les comparaisons d'egalite ou d'inegalite ne posent pas de probleme particulier. Par 
exemple, cl == c2 sera vrai si cl et c2 ont la meme valeur, c'est-a-dire si cl et c2 contien- 
nent des caracteres de meme code, done si cl et c2 contiennent le meme caractere, De meme, 
cl == 'e' sera vrai si le code de cl est egal au code de V, done si cl contient le caractere e. 

En revanche, pour les comparaisons d'inegalite, le resultat fera intervenir le codage des 
caracteres concernes. Rappelons que Java impose Unicode, ce qui implique les relations 
suivantes : 

'0' < T < '2' < ... < '9' < 'A' <'B' < 'C < ...< 'Z' < 'a' < 'b' < 'c' < ... <Y 

4.4 Cas particulier des operateurs == et != 

En plus des situations evoquees precedemment (expressions numeriques ou de type carac- 
tere), ces operateurs peuvent s'appliquer a des valeurs de type booleen. L' expression suivante 
a un sens : 

a < b == c < d 

Compte tenu des priorites relatives des operateurs concernes, elle sera interpretee comme : 
(a < b) == (c < d) 

Elle sera vraie si les deux comparaisons a<b et c<d sont soit toutes les deux vraies, soit 
toutes les deux fausses. 
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Remarque 

Nous verrons plus tard que les operateurs == et != peuvent aussi s'appliquer a des objets 
(en fait a des references a des objets), ainsi qu'a des tableaux (qui sont en fait des objets). 

5 Les operateurs logiques 

5.1 Generates 

Java dispose d'operateurs logiques dont voici la liste, classee par priorites decroissantes (il 
n'existe pas deux operateurs ayant la meme priorite). Nous reviendrons un peu plus loin sur 
l'existence d'operateurs voisins (& et &&, I et II). 



Operateur 


Signification 


! 


negation 


& 


et 


A 


ou exclusif 


I 


ou inclusif 


&& 


et (avec court-circuit) 


II 


ou inclusif (avec court-circuit) 



Les operateurs logiques 

Par exemple : 

(a<b)&&(c<d) ou (a<b)&(c<d) 

prend la valeur true (vrai) si les deux expressions a<b et c<d sont toutes les deux vraies, la 
valeur false (faux) dans le cas contraire. 

(a<b)ll(c<d) ou (a<b)l(c<d) 

prend la valeur true si l'une au moins des deux conditions a<b et c<d est vraie, la valeur 
false dans le cas contraire. 

(a<b) A (c<d) 

prend la valeur true si une et une seule des deux conditions a<b et c<d est vraie, la valeur 
false dans le cas contraire. 

! (a<b) 

prend la valeur true si la condition a<b est fausse, la valeur false dans le cas contraire. Cette 
expression possede en fait la meme valeur que a>=b. 
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5.2 Les operateurs de court-circuit && et || 

Les deux operateurs && et II jouissent d'une propriete interessante : leur second operande 
(celui qui figure a droite de l'operateur) n'est evalue que si la connaissance de sa valeur est 
indispensable pour decider si l'expression correspondante est vraie ou fausse. Par exemple, 
dans une expression telle que : 

a<b && c<d 

on commence par evaluer a<b. Si le resultat est faux, il est inutile d'evaluer c<d puisque, de 
toute facon, l'expression complete aura la valeur faux. 

En revanche, les operateurs voisins que sont & et I evaluent toujours leurs deux operances. II 
en va de meme pour A . 

La connaissance de cette propriete est indispensable pour maitriser des constructions telles 
que (ici, t designe un tableau d'entiers) : 

if ( i<max && t[i++] != 0) 

En effet, le second operande de l'operateur &&, a savoir t[i++] != 0 provoque une incremen- 
tation de i, laquelle n'aura lieu que la si la premiere condition (i<max) est vraie. En revanche, 
avec : 

if ( i<max & t[i++] != 0) 
1' incrementation de i se produirait dans tous les cas. 

5.3 Priorites 

L'operateur ! a une priorite superieure a celle de tous les operateurs arithmetiques binaires et 
aux operateurs relationnels. Ainsi, pour ecrire la condition contraire de : 

a==b 

il est necessaire d'utiliser des parentheses : 

!(a==b) 
En effet, l'expression : 

! a==b 
serait interpreted comme : 

(!a)==b 

Elle conduirait en fait a une erreur de compilation 1 . 



1. A moins que a et b ne soient des variables de type boolean. 
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L'operateur II est moins prioritaire que &&. Tous deux sont de priorite inferieure aux opera- 
teurs arifhmetiques ou relationnels. Ainsi, les expressions utilisees comme exemples au debut 
de ce paragraphe auraient pu, en fait, etre ecrites sans parentheses : 

a<b && c<d equivaut a (a<b) && (c<d) 

a<b II c<d equivaut a (a<b) II (c<d) 

Les memes remarques pourraient s'appliquer a &, I ou A . Notez bien cependant que le 
melange des operateurs de court-circuit avec les autres peut s'averer delicat ; par exemple 
&& est plus prioritaire que II, mais moins que son equivalent sans court-circuit &. 

JJf En C++ 

II n'existe pas d' operateurs & et I. Les operateurs && et II existent et sont egalement a 
court-circuit. Enfin, l'operateur A (ou exclusif) n'existe pas. 

6 L'operateur d'affectation usuel 

Nous avons deja eu l'occasion de remarquer que ; = 5 etait une expression qui : 

• realisait une action : 1' affectation de la valeur 5 a i, 

• possedait une valeur : celle de i apres affectation, c'est-a-dire 5. 

Cet operateur d'affectation (=) peut faire intervenir d' autres expressions, comme dans : 
c = b + 3 

La faible priorite de cet operateur = (elle est inferieure a celle de tous les operateurs arithme- 
tiques et de comparaison) fait qu'il y a d'abord evaluation de l'expression b + 3. La valeur 
ainsi obtenue est ensuite affectee a c. 

6.1 Restrictions 

Comme on s'y attend, il n'est pas possible de faire apparaitre une expression comme premier 
operande de cet operateur =. Ainsi, l'expression suivante n'aurait pas de sens : 

c + 5 = x 

D'une maniere generate, l'operateur d'affectation impose que son premier operande soit une 
reference a un emplacement dont on peut effectivement modifier la valeur. Pour 1' instant, 
nous savons que les variables repondent a une telle condition, pour peu qu'elles ne soient pas 
declarees avec F attribut final. Plus tard, nous verrons que l'operateur d'affectation peut aussi 
s'appliquer a des objets 1 ou a des elements d'un tableau 2 . 



1. Cependant, dans ce cas, il portera sur les references aux objets et non sur leurs valeurs. 

2. En C/C++, il existe beaucoup plus de possibilites pour 1' affectation (en particulier, par le biais de pointeurs), ce qui 
impose de definir un terme (en general lvalue) pour designer les expressions auxquelles on peut l'appliquer. 




Les operateurs et les expressions 



Chapitre 4 



6.2 



Associativite de droite a gauche 



Contrairement a tous ceux que nous avons rencontres jusqu'ici, cet operateur d' affectation 
possede une associativite de droite a gauche. C'est ce qui permet a une expression telle que : 



d'evaluer d'abord F expression j = 5 avant d'en affecter la valeur (5) a la variable /'. Bien 
entendu, la valeur finale de cette expression est celle de i apres affectation, c'est-a-dire 5. 



Considerons ces instructions : 

int n, p ; 
n = p + 5 ; 

On affecte une valeur de type int (resultat du calcul de l'expression p+5) a une variable n du 
meme type. Aucun probleme ne se pose. 

Considerons maintenant : 

float x ; int p ; 



Cette fois, on demande d' affecter une valeur de type int a une variable de type^oaf. Java 
l'accepte, moyennant simplement la mise en place d'une conversion de int en float, compara- 
ble a celle qui peut intervenir dans une conversion d'ajustement de type, dont on sait qu'elle 
ne degrade pas (trop) la valeur. 

En revanche, les choses sont moins satisfaisantes avec ces instructions : 

int n ; float x ; 



En effet, 1' affectation sera cette fois rejetee en compilation. Java refuse de convertir une 
valeur de type float en int, du moins lorsqu'on ne le lui demande pas explicitement, ce qui est 
le cas ici 1 . 

D'une maniere generale, les conversions qui sont permises lors d'une affectation sont celles 
qui ne modifient pas la valeur d'origine ou qui la modifient peu. Ce sont celles que Ton a deja 
rencontrees a la fois dans les promotions numeriques et dans les conversions d'ajustement de 
type avec, en plus, des possibilites de conversion de byte en short. On peut resumer cela en 



i=j = 5 



6.3 



Conversions par affectation 



6.3.1 Generalites 



x = p + 5 ; 



n = x + 5 



1 . Nous verrons plus loin comment imposer explicitement une telle conversion. 
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disant que les conversions implicites sont celles qui se font suivant l'une des deux hierarchies 
suivantes : 



1 Parmi les conversions legales, on trouve celle de char en int, mais pas celle de char en 
short. En effet, bien que ces deux types soient de meme taille, le type short est destine a 
des nombres relatifs avec signe, tandis que, par convention, la conversion d'une valeur de 
type char doit toujours fournir un resultat positif. Le type short s'avere alors trop petit 
pour accueillir toutes les valeurs possibles. 

2 Les conversions de byte en char ou de short en char ne sont pas des conversions impli- 
cites legales. 

3 Nous rencontrerons d'autres conversions legales par affectation a propos des objets et 
des tableaux. 

4 Distinguez bien les conversions implicites mise en ceuvre automatiquement dans les 
calculs d'expression (conversions d'ajustement de type et promotions numeriques) et 
les conversions implicites provoquees par une affectation. Les premieres sont mises en 
place par le compilateur, les secondes par le programmeur. Notez toutefois que les pre- 
mieres constituent un sous-ensemble des secondes. 



En C/C++, toutes les conversions numeriques sont legales par affectation. Certaines 
peuvent alors fortement degrader les informations correspondantes... 

6.3.2 Quelques consequences 

Les regies de promotions numeriques de Java peuvent parfois avoir des consequences insi- 
dieuses au niveau de 1' affectation. En voici un exemple relatif aux promotions de byte en int : 

int n ; 
short p ; 
byte bl, b2 ; 



n = bl * b2 ; //OK car 1' expression bl * b2 est de type int 

p = bl * b2 ; // erreur de compilation : on ne peut affecter int a short 

Le remede, dans ce cas, consistera a recourir a une conversion forcee (cast) dont nous parle- 
rons au paragraphe 9. 



byte --> short -> int -> long -> float -> double 
char -> int -> long -> float -> double 



Les conversions implicites legales 




Remarques 



£Jf En C++ 
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Par ailleurs, une conversion de int en float peut conduire a une legere perte de precision pour 
les grandes valeurs, comme le montre ce programme : 

public class ErrConv 

{ public static void main (String args[ ] ) 
{ int n ; 
float x ; 

n = 1234 ; 
x = n ; 

System. out .println ("n : " + n + " x : " + x) ; 

n = 123456789 ; 
x = n ; 

System. out .println ("n : " + n + " x : " + x) ; 

} 

} 

n : 1234 x : 1234.0 

n : 123456789 x : 1.23456792E8 



Perte de precision dans la conversion int -> float 

Si, par megarde, vous faites afficher la valeur de x-n, vous obtiendrez 0, ce qui pourrait laisser 
croire a l'egalite des deux valeurs. En fait, vous ne faites que soustraire deux valeurs appro- 
chees (egales) de n, mais non egales a n. En revanche, en faisant appel a l'operateur de cast 
presente plus tard, vous pourriez proceder ainsi pour mettre en evidence l'erreur de conver- 
sion (avec les memes valeurs que dans le deuxieme cas du programme precedent, vous 
obtiendrez un ecart de 3) : 

x = n ; 

int na = (int) x 

System. out. println ("ecart" + na-n) ; 

6.3.3 Cas particulier des expressions constantes 

Pour d'evidentes raisons de facilite d'ecriture, Java autorise des affectations telles que celle- 
ci : 

short p ; 



p = 123 ; // accepte bien que 123 soit une constante de type int 

D'une maniere generale, vous pouvez affecter n'importe quelle expression constante entiere 
a une variable de type byte, short ou char, a condition que sa valeur soit representable dans le 
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type voulu (si ce n'est pas le cas, vous obtiendrez une erreur de compilation). Voici un autre 
exemple : 

final int N = 50 ; 

short p = N ; // OK : p recoit la valeur 50 

char c = 2*N + 3 ; // OK : c est le caractere de code 103 
byte b = 10*N ; // erreur de compilation : 500 est superieur 

// a la capacite du type byte 

7 Les operateurs d'incrementation 
et de decrementation 

7.1 Leur role 

Dans des programmes ecrits dans un langage autre que Java (ou C), on rencontre souvent des 
expressions (ou des instructions) telles que : 

i = i+ 1 

n = n - 1 

qui incrementent ou qui decrementent de 1 la valeur d'une variable. En Java, ces actions peu- 
vent etre realisees par des operateurs unaires portant sur cette variable. Ainsi, l'expression : 

++i 

a pour effet d'incrementer de 1 la valeur de ;, et sa valeur est celle de i apres incrementa- 
tion. 

La encore, comme pour 1' affectation, nous avons affaire a une expression qui non seulement 
possede une valeur, mais qui, de surcroit, realise une action (incrementation de i). 

II est important de voir que la valeur de cette expression est celle de i apres incrementation. 
Ainsi, si la valeur de i est 5, l'expression : 

n = ++i - 5 

affectera a ; la valeur 6 et a n la valeur 1 . 

En revanche, lorsque cet operateur est place apres son unique operande, la valeur de l'expres- 
sion correspondante est celle de la variable avant incrementation. Ainsi, si i vaut 5, 
l'expression : 

n = i++ - 5 

affectera a i la valeur 6 et a n la valeur 0 (car ici la valeur de l'expression i++ est 5). 
On dit que ++ est : 

• un operateur de preincrementation lorsqu'il est place a gauche de son operande, 

• un operateur de postincrementation lorsqu'il est place a droite de son operande. 
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Bien entendu, lorsque seul importe l'effet d' incrementation de F operande, cet operateur peut 
etre indifferemment place avant ou apres. Ainsi, ces deux instructions sont equivalentes (ici, 
il s'agit bien d' instructions car les expressions sont terminees par un point-virgule - leur 
valeur se trouve done inutilisee) : 

i++ ; 

++i ; 

De la meme maniere, il existe un operateur de decrementation note — qui est : 

• un operateur de predecrementation lorsqu'il est place a gauche de son operande, 

• un operateur de postdecrementation lorsqu'il est place a droite de son operande. 

Tous ces operateurs peuvent s'appliquer a tous les types numeriques (pas necessairement 
entiers) ainsi qu'au type char. 

7.2 Leurs priorites 

Les priorites elevees de ces operateurs unaires (voir le tableau recapitulatif en fin de chapitre) 
permettent d'ecrire des expressions assez compliquees sans qu'il soit necessaire d'employer 
des parentheses pour isoler leur operande. Ainsi, l'expression suivante a un sens : 

3 * i++ * j- + k++ 

\^^~ Remarque 

II est toujours possible (mais non obligatoire) de placer un ou plusieurs espaces entre un 
operateur et les operandes sur lesquels il porte. C'est ce que nous faisons souvent pour 
accroitre la lisibilite de nos instructions. Cependant, dans le cas des operateurs d'incre- 
mentation, nous avons plutot tendance a l'eviter, cela pour mieux rapprocher F operateur 
de son operande. 

7.3 Leur interet 
7.3.1 Alleger I'ecriture 

Ces operateurs allegent I'ecriture de certaines expressions et offrent surtout le grand avantage 
d'eviter la redondance qui est de mise dans la plupart des autres langages. En effet, dans une 
notation telle que : 

i++ 

on ne cite qu'une seule fois la variable concernee alors qu'on est amene a le faire deux fois 
dans la notation : 



i = i+ 1 
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Les risques d'erreurs de programmation s'en trouvent quelque peu limites. Bien entendu, cet 
aspect prendre d'autant plus d'importance que l'operande correspondant sera d'autant plus 
complexe. 

D'une maniere generale, nous utiliserons frequemment ces operateurs dans la manipulation 
de tableaux ou de chaines de caracteres. Anticipant sur les chapitres suivants, nous pouvons 
indiquer qu'il sera possible de lire 1' ensemble des valeurs d'un tableau d'entiers nomme t en 
repetant la seule instruction : 

t [i++] = Clavier.lirelnt() ; 

Celle-ci realisera a la fois : 

• la lecture d'un nombre entier au clavier, 

• 1' affectation de ce nombre a F element de rang i du tableau t, 

• 1' incrementation de 1 de la valeur de i (qui sera ainsi preparee pour la lecture du prochain 
element). 

7.3.2 Eviter des conversions 

Considerons ces instructions : 

byte b ; 

b = b + 1 ; // erreur de compilation : b+1 de type int ne peut pas etre 

// affecte a un byte 
b++ ; //OK 

Les operateurs d' incrementation n'appliquent pas de conversion a leur operande (ce qui 
d'ailleurs n'aurait aucun sens). Ainsi on remarque que l'expression b+ + ne peut pas etre 
remplacee simplement par b = b+1 qui est illegale. Pour obtenir le meme resultat, il faudrait 
en fait recourir a une conversion explicite en ecrivant : 

b = (byte) (b + 1) 

Les memes considerations s'appliqueraient a une variable c de type char. L'expression C+ + 
n'est pas equivalente a c = c + 1 qui est illegale mais a : 

c = (char) (c + 1) 

8 Les operateurs d'affectation elargie 

8.1 Presentation generale 

Nous venons de voir comment les operateurs d' incrementation permettaient de simplifier 
l'ecriture de certaines affectations. Par exemple i++ remplace avantageusement : 

i = i+ 1 

Mais Java dispose d'operateurs encore plus puissants. Ainsi, vous pourrez remplacer : 
i = i + k 
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par : 

i+=k 
ou, mieux encore : 

a = a * b 
par : 

a*= b 

D'une maniere generale, Java permet de condenser les affectations de la forme : 
variable = variable operateur expression 

en : 

variable operateur= expression 

Cette possibilite concerne tous les operateurs binaires arithmetiques et de manipulation de 
bits. Voici la liste complete de tous ces nouveaux operateurs d' affectation elargie 1 : 

+= -= *= /= %= |= A = &= <<= >>= >>>= 

Comme ceux decrementation, ces operateurs permettent de condenser l'ecriture de certai- 
nes instructions et contribuent a eviter la redondance frequemment introduite par 1' operateur 
d' affectation classique. 



1 Ne confondez pas F operateur de comparaison <= avec un operateur d' affectation elargie. 
Notez bien que les operateurs de comparaison ne sont pas concernes par cette possibilite 
(pas plus que les operateurs logiques). 

2 Tous ces operateurs de la forme Op= sont definis pour les memes types que l'operateur 
Op correspondant. Ainsi, +* est defini comme * pour tous les types numeriques. En 
revanche, nous verrons que I n'est defini que pour des types entiers ; il en va de meme 
pour l=. 

Nous verrons egalement que l'operateur + possede une signification lorsqu'au moins un 
de ses operandes est de type chaine (comme dans "valeur : " + n) ; il en va de meme 
pour +=. 





Remarques 



8.2 Conversions forcees 



Considerons : 



1. Les six derniers correspondent en fait a des operateurs de manipulation de bits (I, A , &, «, » et »>) que 
nous etudierons un peu plus loin. Notez que &=, 1= et A = n'ont rien a voir avec les operateurs logiques etudies 
precedemment. 
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byte b ; 



b += 3 



b = 



b + 3 



// erreur de compilation : b+3, de type int, ne peut pas 
// etre affecte a un byte 
// OK 



Avec b+=3, l'expression b+3 est d'abord evaluee dans le type int ; mais ce resultat est 
ensuite converti dans le type de b (ici byte). Comme les affectations usuelles, les affectations 
elargies impliquent une conversion dans le type de leur (unique) operande. Mais contraire- 
ment a ces dernieres, elles acceptent une conversion ne respectant pas les hierarchies legales. 
Tout se passe alors comme si Ton avait force explicitement cette conversion, en utilisant 
l'operateur dit de cast que nous etudierons un peu plus loin 1 : 
b = (byte) (b+3) ; 

On notera que cette propriete a des consequences insidieuses, comme le montre cet exemple 
(nous verrons au paragraphe 9 le role exact des conversions forcees ne respectant pas les hie- 
rarchies des types) : 

public class ErrAffEl 

{ public static void main (String args[ ] ) 
{ byte b=10 ; 
int n = 10000 ; 
b+=n ; 

System. out. println ("b = " + b) ; 



S'il le souhaite, le programmeur peut forcer la conversion d'une expression quelconque dans 
un type de son choix, a l'aide d'un operateur un peu particulier nomme cast. 

Si, par exemple, n et p sont des variables de type int, l'expression : 

(double) ( n/p ) 

aura comme valeur celle de l'expression entiere n/p convertie en double. 



b = 



26 



Exemple de conversion forcee par V operateur += 



9 L'operateur de cast 



9.1 Presentation generale 



1. C'est d'ailleurs par une telle equivalence que les specifications de Java definissent le role exact des differents 
operateurs d'affectation elargie. 
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La notation (double) correspond en fait a un operateur unaire dont le role est d'effectuer la 
conversion dans le type double de l'expression sur laquelle il porte. Notez bien que cet opera- 
teur force la conversion du resultat de l'expression et non celle des differentes valeurs qui 
concourent a son evaluation. Autrement dit, ici, il y a d'abord calcul, dans le type int, du quo- 
tient de n par/7 ; c'est seulement ensuite que le resultat sera converti en double. Si n vaut 10 
et p vaut 3, cette expression aura comme valeur 3. 

9.2 Conversions autorisees par cast 

II existe autant d' operateurs de cast que de types differents (y compris les types classe que 
nous rencontrerons ulterieurement). Leur priorite elevee (voir tableau en fin de chapitre) fait 
qu'il est generalement necessaire de placer entre parentheses l'expression concernee. Ainsi, 
l'expression : 

(double) n/p 

conduirait d'abord a convertir n en double ; les regies de conversions implicites ameneraient 
alors a convertir p en double avant qu'ait lieu la division (en double). Le resultat serait alors 
different de celui obtenu par l'expression proposee au debut de ce paragraphe (avec les 
memes valeurs de n et de p, on obtiendrait une valeur de l'ordre de 3.33333....). 

En Java, toutes les conversions d'un type numerique (ou caractere) vers un autre type nume- 
rique (ou caractere) sont realisables par cast et ne conduisent jamais a une erreur d' execution. 
Or considerons par exemple : 

int n = 1000 ; 
byte b ; 



b = (byte) n ; // legal 
II est clair que la valeur 1000 n'est pas representable dans le type byte. Malgre tout, Java exe- 
cute la conversion en se contentant ici de n'en conserver que les 8 bits les moins significa- 
tifs.On obtiendra ainsi (en toute legalite !) une valeur totalement differente de celle d'origine 
(en F occurrence -24). 

D'une maniere generale, on peut dire que si la valeur a convertir est representable dans le 
type d'arrivee, la conversion ne provoquera au pire qu'une perte de precision. Dans les autres 
cas, le resultat sera fantaisiste. Ici, il s'agissait d'une troncature classique par perte des bits 
les plus significatifs. D' autres situations peuvent exister, dans le cas de conversions de fiot- 
tant en entier. Le paragraphe suivant presente les regies exactes utilisees par Java dans tous 
les cas. 

Remarques 

1 Nous verrons qu'en dehors des conversions numeriques, on pourra forcer la conversion 
d'un objet d'une classe de base en un objet d'une classe derivee (la conversion inverse 
etant legale de fa5on implicite). 
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2 II est possible d'employer un operateur de cast alors meme qu'il n'est pas 
indispensable : 

long n ; int p ; 

n = (long) p ; // OK, mais equivalent a n = p 

9.3 Regies exactes des conversions numeriques 

En general, vous pourrez vous contenter de ce que nous avons dit precedemment a propos des 
conversions. Nous vous presentons quand meme les regies exactes utilisees par Java, qui a le 
merite de definir exactement le resultat (meme lorsqu'il est faux !), et ce quelle que soit 
1' implementation concernee. 

Notez que nous parlons de conversion non degradante pour qualifier une conversion qui se 
fait suivant l'une des hierarchies legales (presentees au paragraphe 6.3.1) et de conversion 
degradante dans les autres cas. Ici, le terme generique flottant designe l'un des types float ou 
double. De meme, le terme generique entier designe l'un des types byte, short, char, int ou 
long. 



Type de 
conversion 


Nature de la conver- 
sion 


Regies de conversion 


Non 

degra- 
dante 


Entier -> entier 


Valeur conservee. 


float -> double 


Valeur conservee, y compris pour la valeur 0 (avec 
son signe), NaN et les valeurs infinies (par exem- 
ple Float.POSITIVE INFINITY devient 
Double. POSITIVEJNFINITY) . 


entier -> flottant 


Arrondi au plus proche. 
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Type de 
conversion 


Nature de la conver- 
sion 


Regies de conversion 


Degra- 
dante 


entier -> entier 


Conservation des octets les moins significatifs 

(meme dans le cas long -> int). 

Attpntinn Ipq vpIpiicq m^yimalp^ ^ont pIIp^ pii^qi 

niLCI ILIUM, ICO VQluUI O II IdAI 1 1 1 d 1 Co OU 1 L CIICO QUOOl 

soumises a ce mecanisme ; par exemple, 
Long. MAX VALUE n'est pas transforme en 
lnteger.MAX_VALUE. 


double -> float 


Arrondi au plus proche. 

Les valeurs 0 (avec leur signe), NaN et les 
valeurs infinies sont conservees (par exemple 
Double.POSITIVE INFINITY devient 
Float.POSITIVEJNFINITY) 


flottant -> entier 


1 - Dans un premier temps, il y a arrondi au plus 
proche dans le type long (si conversion en long) 
ou int (si conversion en byte, char, short ou int) ; 
NaN devient 0 et les valeurs infinies deviennent la 
valeur maximale du type. 

2 - Ensuite, s'il y a lieu (conversion en byte, short 
ou char) , on effectue la conversion dans le type 
final, en conservant les octets les moins significa- 
tifs 
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Voici un petit programme illustrant quelques cas : 

public class RegConv 

{ public static void main (String args[ ] ) 



float x ; double y ; int n 


; short 


p ; 














y = 


le-300 ; 






















x = 


(float) y ; 


System 


out 


println 


( "double-float : 


" + 


y 


+ 1 


— > 


' + 


x) 


y = 


-le-300 ; 






















X = 


(float) y ; 


System 


out 


println 


( "double-float : 


" + 


y 


+ ' 


— > 


' + 


x) 


y = 


le+300 ; 






















X 


(float) y ; 


System 


out 


println 


( "double-float : 


" + 


y 


+ ' 


— > 


' + 


x) 


' = 


123456789. f 






















n = 


(int) x ; 


System 


out 


println 


("float-int : 


" + 


X 


+ ' 


— > 


' + 


n) 


P = 


(short) x ; 


System 


out 


println 


("float-short : 


" + 


x 


+ ' 


— > 


' + 


P) 


x = 


1.23456789el5f ; 




















n = 


(int) x ; 


System 


out 


println 


("float-int : 


" + 


x 


+ ' 


— > 


' + 


n) 


P = 


(short) x ; 


System 


out 


println 


("float-short : 


" + 


x 


+ 1 


— > 


' + 


P) 


x = 


32771. f ; 






















n = 


(int) x ; 


System 


out 


println 


("float-int : 


" + 


X 


+ ' 


— > 


' + 


n) 


P = 


(short) x ; 


System 


out 


println 


("float-short : 


" + 


X 


+ ' 


— > 




P) 



} 

) 
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double-float 

double-float 

double-float 

float-int 

float-short 

float-int 

float-short 

float-int 

float-short 



1.0E-300 — > 0.0 
-1.0E-300 — > -0.0 
1.0E300 — > Infinity 
1.23456792E8 — > 123456792 
1.23456792E8 — > -13032 
1.23456795E15 — > 2147483647 
1.23456795E15 — > -1 
32771.0 — > 32771 
32771.0 — > -32765 



Quelques exemples de conversions numeriques 



10 Les operateurs de manipulation de bits 

10.1 Presentation generale 

Java dispose (comme le langage C) d' operateurs permettant de travailler directement sur le 
motif binaire d'une valeur. Ceux-ci lui procurent ainsi des possibilites traditionnellement 
reservees a la programmation en langage assembleur. 

Compte tenu de leur vocation, ces operateurs ne peuvent porter que sur des types entiers. 
Theoriquement, ils ne sont definis que pour des operandes de meme type parmi int ou long. 
Mais tous ces operateurs soumettent leurs operandes aux conversions implicites (ajustement 
de type et promotions numeriques), exactement comme le font les operateurs arithmetiques. 
Ils pourront done, en definitive, disposer d' operandes de l'un des types byte, short, char, int 
ou long. 

Le tableau suivant fournit la liste de ces operateurs, qui se composent de six operateurs binai- 
res (a deux operandes) et d'un operateur unaire (a un seul operande) : 



Operateur 


Signification 


& 


et (bit a bit) 


I 


ou inclusif (bit a bit) 


A 


ou exclusif (bit a bit) 


« 


decalage a gauche 


» 


decalage arithmetique a droite 


»> 


decalage logique a droite 


~ (unaire) 


complement a un (bit a bit) 
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10.2 Les operateurs bit a bit 

Les trois operateurs &, I et A appliquent en fait la meme operation a chacun des bits des deux 
operandes. Leur resultat peut ainsi etre defini a partir de la table suivante (dite "table de 
verite") fournissant le resultat de cette operation lorsqu'on la fait porter sur deux bits de 
meme rang de chacun des deux operandes. 



Operande 1 


0 


0 


1 


1 


Operande 2 


0 


1 


0 


1 


et (&) 


0 


0 


0 


1 


ou inclusif (|) 


0 


1 


1 


1 


ou exclusif ( A ) 


0 


1 


1 


0 



Table de verite des operateurs "bit a bit" 

L'operateur unaire ~ (dit de "complement a un") est egalement du type "bit a bit". II se con- 
tente d'inverser chacun des bits de son unique operande (0 donne 1 et 1 donne 0). 

Voici quelques exemples de resultats obtenus a l'aide de ces operateurs. Nous avons suppose 
que les variables n et p etaient toutes deux du type int. Nous avons systematiquement indique 
les valeurs sous forme binaire en ajoutant un espace tous les 8 bits, (pour plus de lisibilite), 
puis sous forme hexadecimale et decimale (bien que cette derniere n'ait guere de significa- 
tion dans ce cas) : 



00000000 00000000 00000101 01101110 
00000000 00000000 00000011 10110011 



0000056E 
000003B3 



1390 
947 



n s p 00000000 00000000 00000001 00100010 00000122 290 

n | p 00000000 00000000 00000111 11111111 000007FF 2047 

n * p 00000000 00000000 00000110 11011101 000006DD 1757 

~ n 11111111 11111111 11111010 10010001 FFFFFA91 -1391 



Tous ces operateurs emploient les memes regies de promotions numeriques et de conversions 
d'ajustement de type que les operateurs arithmetiques. Ainsi, avec : 

int n ; short p ; 

l'expression n&p sera de type int (p aura subi une promotion numerique en int). De la meme 
facon, l'expression ~p sera de type int, ce qui fait que l'instruction suivante sera rejetee : 

short pi = ~p ; // ~p de type int ne peut etre affecte a un short 

II vous faudra absolument ecrire : 

short pi = (short) ~p ; // on force la conversion de int en short 

En revanche, comme les operateurs d' affectation elargie forcent la conversion (voir paragra- 
phe 8.2), ceci sera correct : 
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byte p ; int n ; 

p &= n ; // OK car equivalent a p = (byte) (p & n) ; 

10.3 Les operateurs de decalage 

lis permettent de realiser des decalages a droite ou a gauche sur le motif binaire correspon- 
dant a leur premier operande. L' amplitude du decalage, exprimee en nombre de bits, est four- 
nie par le second operande. Par exemple : 

n « 2 

fournit comme resultat la valeur obtenue en decalant le "motif binaire" de n de 2 bits vers la 
gauche ; les bits de gauche sont perdus et des bits a zero apparaissent a droite. Notez bien 
que la valeur de n reste inchangee. 

De meme : 

n » 3 

fournit comme resultat la valeur obtenue en decalant le motif binaire de n de 3 bits vers la 
droite. Cette fois, les bits de droite sont perdus, tandis que des bits apparaissent a gauche. Ces 
derniers sont identiques au bit de signe du motif d'origine ; on dit qu'il y a propagation du bit 
de signe. Ainsi, on peut montrer qu'un tel decalage arithmetique de p bits vers la droite 
revient a diviser la valeur par 2p. 

Quant a »>, il fonctionne comme », avec cette difference que les bits introduits a gauche 
sont toujours a zero. 

Voici quelques exemples de resultats obtenus a Faide de ces operateurs de decalage. La varia- 
ble n est supposee de type int : 



n 0011001101111111011101001110111 

n « 2 1100110111111101110100111011100 

n » 3 0000011001101111111011101001110 

n »>3 0000011001101111111011101001110 

n 1111001011101000011101000001110 

n «2 1100101110100001110100000111000 

n »3 1111111001011101000011101000001 

n »>3 0001111001011101000011101000001 



10.4 Exemples d'utilisation des operateurs de bits 

L'operateur & permet d'acceder a une partie des bits d'une valeur en "masquant" les autres. 
Par exemple, l'expression suivante (elle sera du meme type que n) : 

n &0xF 
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permet de ne prendre en compte que les 4 bits de droite de n (que n soit de type byte, char, 
short, int ou long). 

De meme : 

n & 0x80000000 

permet d'extraire le bit de signe de n, suppose de type int. 

Voici un exemple de programme qui decide si un entier est pair ou impair, en examinant sim- 
plement le dernier bit de sa representation binaire : 

public class Parite 

{ public static void main (String args[ ] ) 
{ int n ; 

System. out .print ("donnez un entier : ") ; 
n = Clavier. lirelnt () ; 
if ( (n & 1) == 1) 

System. out. println ("il est impair") ; 
else 

System. out. println ("il est pair") ; 

} 

} 

donnez un entier : 124 
il est pair 

donnez un entier : 87 
il est impair 

Test de la parite d'un nombre entier 



1 1 L'operateur conditionnel 

Considerons F instruction suivante : 

if ( a>b ) 

max = a ; 

else 

max = b ; 

Elle attribue a la variable max la plus grande des deux valeurs de a et de b. La valeur de max 
pourrait etre definie par cette phrase : 

Si a>b alors a sinon b 

En Java, il est possible, grace a V operateur conditionnel, de traduire presque litteralement 
cette phrase de la maniere suivante : 

max = a>b ? a : b 
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L' expression figurant a droite de Foperateur d' affectation est en fait constitute de trois 
expressions (a>b, a et b) qui sont les trois operandes de Foperateur conditionnel, lequel se 
materialise par deux symboles separes : ? et :. 

Cet operateur evalue la premiere expression (il doit s'agir d'une expression booleenne) qui 
joue le role d'une condition. Si cette condition est vraie, il y a evaluation du second operande, 
ce qui fournit le resultat ; si la condition est fausse, il y a evaluation du troisieme operande, ce 
qui fournit le resultat. 

Voici un autre exemple d'une expression calculant la valeur absolue de 3*a + 1 : 

3*a+l >0 ? 3*a+l : -3*a-l 

L' operateur conditionnel jouit d'une faible priorite (il arrive juste avant 1' affectation), de 
sorte qu'il est rarement necessaire d' employer des parentheses pour en delimiter les diffe- 
rents operandes (bien que cela puisse parfois ameliorer la lisibilite du programme). 

Bien entendu, une expression conditionnelle peut, comme toute expression, apparaitre a son 
tour dans une expression plus complexe. Voici, par exemple, une instruction 1 affectant a z la 
plus grande des valeurs de a et de b : 

z = ( a>b ? a : b ) ; 

De me me, rien n'empeche que 1' expression conditionnelle soit evaluee sans que sa valeur 
soit utilisee, comme dans cette instruction : 

a>b ? i++ : i- ; 

Ici, selon que la condition a>b est vraie ou fausse, on incrementera ou on decrementera la 
variable ;. 

12 Recapitulatif des priorites des operateurs 

Le tableau suivant fournit la liste complete des operateurs de Java, classes par ordre de prio- 
rite decroissante et accompagnes de leur mode d'associativite (-> signifiant de gauche a 
droite et <- de droite a gauche). 



1. Notez qu'il s'agit effectivement d'une instruction, car elle se termine par un point-virgule. 
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Operateurs 


Associativite 


(\ n -i— i-fnn^tf iyp^ — fno^tfiYfM 




-i-dmairp^ -dinpirp^ -i--i-(nrpfiY(M — fnrpfiYfM ~fnnpirp^ 1 

cast new 




* / % 


-> 


+ - 


-> 


« » »> 


-> 


<<=>>= instanceof 


-> 


== != 


-> 


& 


-> 


A 


-> 


1 


-> 


&& 


-> 


II 


-> 


?; 


-> 


= += -= *= /= %= «= »= »>= &= |= A = 


<- 
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Attention : certains operateurs possedent plusieurs significations. C'est par exemple le cas de 
&, A et I qui sont a la fois des operateurs logiques et des operateurs de manipulation de bits. 

Notez qu'en Java (comme en C++), un certain nombre de notations se trouvent considerees 
comme des operateurs et, en tant que tels, soumis a des regies de priorites. II s'agit : 

• des references a des elements d'un tableau : operateur [], 

• des references a un champ ou a une methode d'un objet : operateur ., 

• des appels de methodes : operateur (). 
lis seront etudies ulterieurement. 

En C++ 

La plupart des operateurs sont communs a Java et a C++. Dans ce cas, ils possedent la 
meme priorite relative dans les deux langages. 



5 



Les instructions 
de contrdle de Java 



A priori, dans un programme, les instructions sont executees sequentiellement, c'est-a-dire 
dans Fordre ou elles apparaissent. Or la puissance et le comportement intelligent d'un pro- 
gramme proviennent essentiellement de la possibilite de s'affranchir de cet ordre pour effec- 
tuer des choix et des boucles (repetitions). Tous les langages disposent d' instructions, 
nominees instructions de contrdle, permettant de les realiser. Elles peuvent etre : 

• fondees essentiellement sur la notion de branchement (conditionnel ou inconditionnel) ; 
c'etait le cas, par exemple, des premiers Basic ; 

• ou, au contraire, traduire fidelement les structures fondamentales de la programmation 
structuree ; c'est le cas, par exemple, du langage Pascal bien que, en toute rigueur, ce dernier 
dispose d'une instruction de branchement inconditionnel GOTO. 

Java (comme C) est assez proche du Pascal sur ce point puisqu'il dispose instructions 
structurees permettant de realiser : 

• des choix : instructions if...else et switch, 

• des boucles (repetitions) : instructions do... while, while et for. 

Toutefois, la notion de branchement n'est pas totalement absente de Java puisque, comme 
nous le verrons : 

• il dispose destructions de branchement inconditionnel : break et continue, 
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• F instruction de choix multiple que constitue switch est en fait intermediate entre le choix 
multiple parfaitement structure du Pascal et Faiguillage multiple du Fortran. 

Ce sont ces differentes instructions de controle de Java que nous nous proposons d'etudier 
dans ce chapitre. 

1 Linstruction if 

Nous avons deja rencontre des exemples d' instruction //"et nous avons vu que cette derniere 
pouvait eventuellement faire intervenir un bloc. Precisons done tout d'abord ce qu'est un 
bloc. 

1.1 Blocs d'instructions 

Un bloc est une suite d'instructions placees entre accolades ({ et }). Les instructions figurant 
dans un bloc sont absolument quelconques. II peut s'agir aussi bien d'instructions simples 
(terminees par un point- virgule) que d'instructions structurees (choix, boucles), lesquelles 
peuvent a leur tour renfermer d'autres blocs... 

Rappelons qu'en Java comme en Pascal ou en C++, il y a une sorte de recursivite de la notion 
d' instruction. Dans la description de la syntaxe des differentes instructions, le terme d' ins- 
truction designera toujours n'importe quelle instruction Java : simple, structuree ou un bloc. 

Un bloc peut se reduire a une seule instruction, voire etre vide. Voici deux exemples de blocs 
corrects : 

{ } 

{i=i;} 

Le second bloc ne presente aucun interet en pratique puisqu'il pourra toujours etre remplace 
par 1' instruction simple qu'il contient. 

En revanche, nous verrons que le premier bloc (lequel pourrait a priori etre remplace par... 
rien) apportera une meilleure lisibilite dans le cas de boucles ayant un corps vide. 

Notez encore que { ; } est un bloc constitue d'une seule instruction vide, ce qui est syntaxi- 
quement correct. 

\^^~ Remarque 

N'oubliez pas que toute instruction simple est toujours terminee par un point-virgule. 
Ainsi, ce bloc : 

{ i = 5 ;k = 3 j 

est incorrect car il manque un point-virgule a la fin de la seconde instruction qu'il con- 
tient. 
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D'autre part, un bloc joue le meme role syntaxique qu'une instruction simple (point- 
virgule compris). Evitez done d'ajouter des points-virgules intempestifs a la suite d'un 
bloc. 

1 .2 Syntaxe de l'instruction if 

Le mot else et l'instruction qu'il introduit etant facultatifs, l'instruction // presente deux 
formes : 



if (condition) 

instruction_1 
[ else 

instruction_2 ] 

L'instruction if 
condition est une expression booleenne quelconque, 

instruction_l et instruction^ sont des instructions quelconques, e'est-a-dire : 

- simple (terminee par un point virgule), 

- structured, 

- bloc. 

N.B. : les crochets [...] signifient que ce qu'ils renferment est facultatif. 

Remarque 

La syntaxe de cette instruction n' impose en soi aucun point- virgule, si ce n'est ceux qui 
terminent naturellement les instructions simples qui y figurent. 

1.3 Exemples 

La richesse de la notion d' expression en Java fait que F expression regissant le choix peut rea- 
liser certaines actions. Ainsi : 

if (++i < limite) System. out. println ("OK") ; 

est equivalent a : 

i = i + 1 ; 

if (i < limite) System. out. println ("OK") ; 

Par ailleurs : 

if ( i++ < limite ) 

est equivalent a : 

i = i + 1 ; 

if ( i-1 < limite ) 
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En revanche : 

if ( ++i<max && ( (c=Clavier . lirelnt () ) !='\n') ) 

n'est pas equivalent a : 

++i ; 

c = Clavier . lirelnt () ; 

if ( Krnax && ( c!= '\n' ) ) 

En effet, l'operateur && n'evalue son second operande que lorsque cela est necessaire. 
Autrement dit, dans la premiere formulation, l'expression : 

c = Clavier. lirelnt () ; 

n'est pas evaluee lorsque la condition ++i<max est fausse ; elle Test, par contre, dans la 
deuxieme formulation. 

1 .4 Imbrication des instructions if 

Nous avons deja mentionne que les instructions figurant dans chaque partie du choix d'une 
instruction pouvaient etre absolument quelconques. Elles peuvent en particulier renfermer a 
leur tour d'autres instructions Compte tenu des deux formes possibles de l'instruction if 
(avec ou sans else), il existe certaines situations oil une ambiguite apparait. C'est le cas dans 
cet exemple : 

if (a<=b) if (b<=c) System. out. println ("ordonne") ; 
else System. out. println ("non ordonne") ; 

Est-il interprete comme le suggere cette presentation ? 

if (a<=b) if (tK=c) System. out .println ("ordonne") ; 
else System. out. println ("non ordonne") ; 

Ou bien comme le suggere celle-ci ? 

if (a<=b) if (b<=c) System. out. println ("ordonne") ; 

else System. out. println ("non ordonne") ; 

La premiere interpretation conduirait a afficher "non ordonne" lorsque la condition a<=b est 
fausse, tandis que la seconde n'afficherait rien. La regie adoptee par Java pour lever une telle 
ambiguite est la suivante : 

Un else se rapporte toujours au dernier if rencontre auquel un else n'a pas encore ete 
attribue. 

Dans notre exemple, c'est la seconde presentation qui suggere le mieux ce qui se passe. 

Voici un exemple d'utilisation de if imbriques. II s'agit d'un programme de facturation avec 
remise. II lit en donnee un simple prix hors taxes et calcule le prix TTC correspondant (avec 
un taux de TVA constant de 18,6%). II etablit ensuite une remise dont le taux depend de la 
valeur ainsi obtenue, a savoir : 

• 0 % pour un montant inferieur a 1 000 F, 

• 1 % pour un montant superieur ou egal a 1 000 F et inferieur a 2 000 F, 

• 3 % pour un montant superieur ou egal a 2 000 F et inferieur a 5 000 F, 
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• 5 % pour un montant superieur ou egal a 5 000 F. 

Ce programme est accompagne de deux exemples d' execution. 

public class Tva 

{ public static void main (String ] args) 
{ double taux_tva = 21.6 ; 

double ht, ttc, net, tauxr, remise ; 

System. out. print ("donnez le prix hors taxes : ") ; 

ht = Clavier . lireDouble () ; 

ttc = ht * ( 1. + taux_tva/100.) ; 

if ( ttc < 1000.) tauxr = 0 ; 

else if ( ttc < 2000 ) tauxr = 1. ; 

else if ( ttc < 5000 ) tauxr = 3. ; 

else tauxr =5. ; 

remise = ttc * tauxr / 100. ; 
net = ttc - remise ; 

System. out. println ("prix ttc " + ttc) ; 
System. out. println ("remise " + remise) ; 

System. out. println ("net a payer " + net) ; 

} 

} 

donnez le prix hors taxes 
prix ttc 4864.0 
remise 145.92 
net a payer 4718.08 

donnez le prix hors taxes : 859.45 
prix ttc 1045.0912 
remise 10.450912 
net a payer 1034.640288 

Exemple de if imbriques : facture avec remise 

2 L'instruction switch 

2.1 Exemples d' introduction 
2.1.1 Premier exemple 

Considerons ce premier exemple de programme, accompagne de trois exemples d' execution : 
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public class Switchl 

{ public static void main (String! ] args) 
{ int n ; 

System. out .print ("donnez un nombre entier : ") ; 
n = Clavier . lirelnt () ; 
switch (n) 

{ case 0 : System. out. println ("nul") ; 
break ; 

case 1 : System. out. println ("un") ; 
break ; 

case 3 : System. out. println ("trois") ; 
break ; 

} 

System. out .println ("Au revoir"); 

} 

} 

donnez un nombre entier : 0 
nul 

Au revoir 

donnez un nombre entier : 3 

trois 

Au revoir 

donnez un nombre entier : 2 
Au revoir 



Premier exemple d' instruction switch 

L'instruction switch s'etend ici sur huit lignes (elle commence au mot switch). Son execution 
se deroule comme suit. On commence tout d'abord par evaluer l'expression figurant apres le 
mot switch (ici n). Puis on recherche dans le bloc qui suit s'il existe une etiquette de la forme 
case x correspondant a la valeur ainsi obtenue. Si tel est le cas, on se branche a l'instruction 
figurant apres cette etiquette. Sinon, on passe a l'instruction qui suit le bloc. 

Par exemple, quand n vaut 0, on trouve effectivement une etiquette case 0 et Ton execute 
l'instruction correspondante, c'est-a-dire : 

System. out. println ("nul") ; 

On passe ensuite naturellement a l'instruction suivante, a savoir ici : 

break ; 

Celle-ci demande en fait de sortir du bloc. Notez bien que le role de cette instruction est fon- 
damental. Voyez, a titre d'exemple, ce que produirait ce meme programme en l'absence 
d' instructions break : 
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public class Switch2 

{ public static void main (String! ] args) 
{ int n ; 

System. out. print ("donnez un nombre entier : ") ; 
n = Clavier . lirelnt () ; 
switch (n) 

{ case 0 : System. out. println ("nul") ; 
case 1 : System. out. println ("un") ; 
case 3 : System. out. println ("trois") ; 

} 

System. out. println ("Au revoir"); 

} 

} 

donnez un nombre entier : 0 

nul 

un 

trois 

Au revoir 

donnez un nombre entier : 3 

trois 

Au revoir 

donnez un nombre entier : 2 
Au revoir 

Quand on oublie les break 

2.1 .2 L' etiquette default 

II est possible d'utiliser le mot-cle default comme etiquette a laquelle le programme se bran- 
chera si aucune valeur satisfaisante n'a ete rencontree auparavant. En voici un exemple : 

public class Default 

{ public static void main (String! ] args) 
{ int n ; 

System . out . print ("donnez un nombre entier : ") ; 
n = Clavier . lirelnt () ; 
switch (n) 

{ case 0 : System. out. println ("nul") ; 
break ; 

case 1 : System. out. println ("un") ; 
break ; 

default : System. out. println ("grand") ; 

} 

System. out. println ("Au revoir"); 

} 

) 
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donnez un nombre entier : 0 
nul 

Au revoir 



donnez un nombre entier : 3 

grand 

Au revoir 



L 'etiquette default 

2.1.3 Un exemple plus general 

D'une maniere generale, on peut trouver : 

• plusieurs instructions a la suite d'une etiquette, 

• des etiquettes sans instructions, c'est-a-dire, en definitive, plusieurs etiquettes successives 
(accompagnees de leurs deux-points). 

Considerons cet exemple, dans lequel nous avons volontairement omis certains break : 

public class Switch3 

{ public static void main (String[ ] args) 
{ int n ; 

System. out .print ("donnez un nombre entier : ") ; 
n = Clavier . lirelnt () ; 
switch (n) 

{ case 0 : System. out. println ("nul") ; 
break ; 

case 1 : 

case 2 : System. out. println ("petit") ; 
case 3 : 
case 4 : 

case 5 : System. out. println ("moyen") ; 
break ; 

default : System. out. println ("grand") ; 

} 

System. out .println ("Au revoir"); 

} 

} 

donnez un nombre entier : 1 

petit 

moyen 

Au revoir 
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grand 

Au revoir 
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Exemple general a" instruction switch 



2.2 Syntaxe de l'instruction switch 



switch (expression) 

{ case constante_1 : [ suite_d instructions_1 ] 
case constante_2 : [ suite_d instructions_2 ] 



case constante_n : [ suite_d instructions_n ] 
[ default : suite_d instructions ] 

} 



expression est une expression de Fun des types byte, short, char ou int 1 (ou enumere depuis 
le JDK 5.0), 

constante_i est une expression constante d'un type compatible par affectation avec le type de 
expression, 

suite _d 'instructions _i est une sequence d' instructions quelconques. 
N.B. : Les crochets [ et ] signifient que ce qu'ils renferment est facultatif. 

Commentaires 

II parait normal que cette instruction limite les valeurs des etiquettes a des valeurs entieres. 
En effet, il ne faut pas oublier que la comparaison d'egalite de la valeur d'une expression fiot- 
tante a celle d'une constante flottante est relativement aleatoire, compte tenu de la precision 
limitee des calculs. 

En revanche, les possibilites de conversion autorisent ce genre de construction : 



L'instruction switch 



int n 



switch (n) 
{ case 280 
case ' A' 



// ' A' est converti dans le type de n (int) 



1 . Notez bien que des expressions de type byte, short ou char ne peuvent etre que de simples variables (a moins 
de recourir a l'operateur de cast). Dans le cas contraire, les regies de conversion implicites conduiront obliga- 
toirement a une expression de type int. Par ailleurs, notez que le type long ne peut pas etre employe ici. 
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De meme, comme une expression constante entiere est compatible avec les types byte, char 
et short, cette construction est correcte : 

char c ; 



switch (c) 

{ case 48 : 

case 'a' : 

} 

Enfin, comme la syntaxe de switch autorise en etiquette non seulement des constantes, mais 
aussi des expressions constantes, l'exemple suivant est correct : 

final int LIMITE = 20 ; 
switch (n) 

{ case LIMITE - 1 : 

case LIMITE : 

case LIMITE + 1 : 

} 

Apres compilation, les expressions LIMITE- 1, LIMITE et LIMITE+1 seront effectivement 
remplacees par les valeurs 19, 20 et 21. 

Remarque 

Les connaisseurs du Pascal trouveront que cette selection realisee par l'instruction switch 
est moins riche que celle offerte par l'instruction CASE, dans la mesure oil elle impose 
d'enumerer les differentes valeurs concernees. En aucun cas, on ne peut fournir un inter- 
valle autrement qu'en citant chacune de ses valeurs. 

£3* En C++ 

C++ dispose d'une instruction switch comparable a celle de Java, avec cette seule diffe- 
rence qu'en theorie, la presence d'un bloc n'y est pas obligatoire (on en utilise pratique - 
ment toujours un). 

3 L'instruction do... while 

Abordons maintenant la premiere facon de realiser une boucle en Java. 

3.1 Exemple d'introduction 

public class Dol 

{ public static void main (String args[ ] ) 
{ int n ; 
do 

{ System. out .print ("donnez un nombre >0 : ") ; 
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n = Clavier . lirelnt () ; 

System. out. println ("vous avez fourni " + n) ; 

} 

while (n <= 0) ; 

System . out . println ("reponse correcte") ; 

} 

} 

donnez un nombre >0 : -4 
vous avez fourni -4 
donnez un nombre >0 : -5 
vous avez fourni -5 
donnez un nombre >0 : 14 
vous avez fourni 14 
reponse correcte 

Exemple d' instruction do... while 

L'instruction : 

do while (n<=0) ; 

repete l'instruction qu'elle contient (ici un bloc) tant que la condition mentionnee (n<=0) est 
vraie. Autrement dit, ici, elle demande un nombre a l'utilisateur (en affichant la valeur lue) 
jusqu'a ce qu'il fournisse une valeur positive. 

A priori, on ne sait pas combien de fois une telle boucle sera repetee. Toutefois, par sa nature 
meme, elle est toujours parcourue au moins une fois. En effet, la condition qui regit cette 
boucle n'est examinee qu'a la fin de chaque repetition (comme le suggere d'ailleurs le fait 
que la partie while figure en fin). 

Notez bien que la sortie de boucle ne se fait qu'apres un parcours complet de ses instructions 
et non des que la condition mentionnee devient fausse. Ici, meme apres que l'utilisateur a 
fourni une reponse convenable, il y a ainsi execution de l'instruction d'affichage : 

System. out .println ("vous avez fourni " + n) ; 

3.2 Syntaxe de l'instruction do... while 



do instruction 
while (condition) ; 

L'instruction do... while 

instruction est une instruction quelconque, 
condition est une expression booleenne quelconque. 
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Commentaires 

1 Notez bien d'une part la presence de parentheses autour de l'expression qui regit la 
poursuite de la boucle, d' autre part la presence d'un point-virgule a la fin de cette ins- 
truction. 

2 Lorsque 1' instruction a repeter se limite a une seule instruction simple, n'omettez pas le 
point-virgule qui la termine. Ainsi : 

do c = Clavier. lirelnt () while ( c != ' ) ; 

est incorrect. II faut absolument ecrire : 

do c = Clavier. lirelnt () ; while ( c != ' yf ) ; 

3 L'instruction a repeter peut etre vide (mais quand meme terminee par un point-virgule). 
Ces constructions sont correctes : 

do ; while ( ... ) ; 



do { } while ( ... ) ; 

4 La construction : 

do { } while (true) ; 

represente une boucle infinie syntaxiquement correcte, mais ne presentant aucun interet 
en pratique. Par contre : 

do instruction while (true) ; 

pourra presenter un interet dans la mesure oil, comme nous le verrons, il sera possible 
d'en sortir par une instruction break. 

5 Si vous connaissez Pascal, vous remarquerez que l'instruction do... while correspond au 
repeat... until avec, cependant, une condition exprimee sous forme contraire. 



TX¥ En C++ 

L'instruction do... while est identique a celle de Java, a ceci pres que les expressions boo- 
leennes n' existent pas et que la condition porte sur la non-nullite d'une expression arith- 
metique quelconque. 



4 L'instruction while 

Abordons maintenant la deuxieme fafon de realiser une boucle conditionnelle. 
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4.1 Exemple d'introduction 

public class Whilel 

{ public static void main (String args[ ] ) 
{ int n, son ; 
som = 0 ; 
while (som < 100) 
{ System . out . print ("donnez un nombre : ") ; 
n = Clavier . lirelnt () ; 
som += n ; 

} 

System. out. println ("Somme obtenue : " + som) ; 

} 

) 



donnez 


un 


nombre : 


15 


donnez 


un 


nombre : 


27 


donnez 


un 


nombre : 


14 


donnez 


un 


nombre : 


56 


Somme obtenue : 112 



Exemple d' instruction while 

La construction : 
while (som<100) 

repete l'instruction qui suit (ici un bloc) tant que la condition mentionnee est vraie, comme le 
ferait do... while. Mais cette fois, la condition de poursuite est examinee avant chaque par- 
cours de la boucle et non apres. Ainsi, contrairement a ce qui se passait avec do... while, une 
telle boucle peut tres bien n'etre parcourue aucune fois si la condition est fausse des qu'on 
l'aborde (ce qui n'est pas le cas ici). 

4.2 Syntaxe de l'instruction while 



while (condition) 
instruction 



L'instruction while 

instruction est une instruction quelconque, 
condition est une expression booleenne quelconque. 
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Commentaires 

1 La encore, notez bien la presence de parentheses pour delimiter la condition de pour- 
suite. En revanche, la syntaxe n'impose aucun point-virgule de fin (il s'en trouvera 
naturellement un a la fin de 1' instruction qui suit si celle-ci est simple). 

2 La condition de poursuite est evaluee avant le premier tour de boucle. II est done neces- 
saire que sa valeur soit definie a ce moment la. Si tel n'est pas le cas, le compilateur 
vous le signalera. 

Linstruction while est identique a celle de Java, a ceci pres que les expressions booleen- 
nes n' existent pas et que la condition porte sur la non-nullite d'une expression arithmeti- 
que quelconque. 

5 Linstruction for 

Etudions maintenant la derniere instruction permettant de realiser des boucles. 

5.1 Exemple d'introduction 

Considerons ce programme : 

public class Fori 

{ public static void main (String args[ ] ) 
{ int i ; 

for (1=1 ; i<=5 ; i++) 
{ System. out. print ("bonjour ") ; 
System. out .print In (i + " fois") ; 

} 

} 

} 

bonjour 1 fois 
bonjour 2 fois 
bonjour 3 fois 
bonjour 4 fois 
bonjour 5 fois 



Exemple d' instruction for 



La ligne : 

for (i=l ; i<=5 ; i++ ) 
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comporte en fait trois expressions. La premiere est evaluee (une seule fois) avant d'entrer 
dans la boucle. La deuxieme conditionne la poursuite de la boucle. Elle est evaluee avant 
chaque parcours. La troisieme, enfin, est evaluee a la fin de chaque parcours. 

Le programme precedent equivaut au suivant : 

public class For2 

{ public static void main (String args! ] ) 
{ int i = 1 ; 
i = 1 ; 

while (i <= 5) 
{ System . out . print ("bonjour ") ; 
System. out. println (i + " fois") ; 
i++ ; 

} 

} 

} 

Pour remplacer line boucle for par une boucle while 

5.2 L'instruction for en general 

Lexemple precedent correspond a l'usage le plus frequent d'une instruction for : 

• la premiere partie correspond a 1' initialisation d'un compteur (ici z), 

• la deuxieme partie correspond a la condition d' arret (i<=5), 

• la troisieme partie correspond a F incrementation du compteur. 

En fait, Java autorise qu'on place en premiere et en troisieme partie une liste d'expressions, 
c'est-a-dire une ou plusieurs expressions (de type quelconque) separees par des virgules. La 
deuxieme partie, en revanche, est obligatoirement une expression booleenne. 

Voici un exemple de programme utilisant ces possibilites : 

public class For3 

{ public static void main (String args[ ] ) 
{ int i, j ; 

for (i=l , j=3 ; i<=5 ; i++, j+=i) 
{ System. out. println ("i = " + i + " j = " + j) ; 
} 

} 

} 

i = 1 j = 3 
i = 2 j = 5 
i = 3 j = 8 
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i = 4 j = 12 
i = 5 j = 17 

La premiere partie de F instruction for peut egalement etre une declaration, ce qui permet 
d'ecrire l'exemple precedent de cette facon : 

public class For4 

{ public static void main (String args[ ] ) 
{ for (int i=l , j=3 ; i<=5 ; i++, j+=i) 

{ System. out. println ("i = " + i + " j = " + j) ; 

} 

} 

} 

Dans ce cas, les variables ; et j sont locales au bloc regis par I'instruction /or. L' emplacement 
correspondant est alloue a Fentree dans F instruction for et il disparait a la fin. 

Ainsi les deux formulations des deux programmes precedents ne sont-elles pas rigoureuse- 
ment equivalentes. Dans le premier cas, en effet, i et j existent encore apres sortie de la bou- 
cle. 



5.3 Syntaxe de I'instruction for 

for ( [initialisation] ; [condition] ; [incr mentationss]) 
instruction 

instruction est une instruction quelconque, 

initialisation est une declaration ou une suite d' expressions quelconques separees par des 
virgules, 

condition est une expression booleenne quelconque, 

incrementations sont des suites d'expressions quelconques separees par des virgules. 
N.B. : Les crochets [ et ] signifient que ce qu'ils renferment est facultatif. 

Commentaires 

1 Chacune des trois parties de I'instruction est facultative. Ainsi, les trois ensembles 
d' instructions suivants sont equivalents : 

for (i=l ; i<=5 ; 
{ System. out. print ("bonjour ") ; 
System. out. println (i + " fois") ; 

} 



5 - L'instruction for 



93 



i=l ; 

for ( ; i<=5 ; i++) // ne pas oublier le premier point-virgule 
{ System. out. print ("bonjour ") ; 
System. out. println (i + " fois") ; 

} 

i=l ; 

for (; i<=5 ; ) 

{ System. out. print ("bonjour ") ; 
System. out. println (i + " fois") ; 
i++ ; 

1 

Si la condition est absente, elle est consideree comme vraie. On pourrait penser que, 
dans ce cas, on aboutit a une boucle infinie. En fait, on verra qu'il est possible qu'une 
telle boucle renferme une instruction break permettant d'y mettre fin. 

2 La generalite de la syntaxe de l'instruction permet de placer plusieurs actions dans les 
differentes parties. Nous avons deja vu : 

for (int i=l , j=3 ; i<=5 ; i++, j+=i) 

On pourrait meme imaginer (bien que ce ne soit guere raisonnable) de remplacer 

for (i=l ; i<= 5 ; i++) . . . 

par : 

for (i=0 ; ++i <= 5 ; ) 

3 La partie initialisation vous demande de choisir entre declaration et liste d' expressions. 
En general, cela s'avere suffisant. Ainsi, nous avons vu que Ton pouvait employer 

for (int i=l, j=3 ; ) 

au lieu de : 

int i, j ; 

for (i=l, j=3 ; ) 

En revanche, vous ne pourrez pas initialiser deux variables de types differentes en les 
declarant dans for : 

for (int i=l, double x=0. ; ) // incorrect 

II vous faudra en declarer au moins une a l'exterieur. 

4 On peut ecrire une boucle dont le corps est vide. Ainsi, les deux constructions : 

for ( ; ; ) ; 
for (;;){} 

sont syntaxiquement correctes. Elles representent des boucles infinies de corps vide 
(n'oubliez pas que, lorsque la seconde expression est absente, elle est consideree 
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comme vraie). En pratique, elles ne presentent aucun interet. En revanche, cette cons- 
truction 

for ( ; ; ) instruction 

est une boucle infinie dont on pourra eventuellement sortir par une instruction break 
(comme nous le verrons un peu plus loin). 

Remarques 

1 Comme dans tous les langages, il faut prendre des precautions avec les compteurs qui ne 
sont pas de type entier. Ainsi, avec une construction telle que : 

for (double x=0. ; x <=1.0 ; x+=0.1) 

le nombre de tours depend de l'erreur d'arrondi des calculs. Pire, avec : 

for (double x=0. ; x !=1.0 ; x+=0.1) 

on obtient une boucle infinie car, apres 10 tours, la valeur de x n'est pas rigoureusement 
egale a 10... 

2 Java ne vous interdit pas une construction telle que : 

for (i=l ; i<=5 ; i++) 
{ 



} 

Si la valeur de i n'est pas modifiee ailleurs dans le corps de boucle, on aboutit a une 
boucle infinie. 

Contrairement a ce qui se passe dans certains langages comme Pascal ou Fortran, 1' ins- 
truction for de Java est en effet une boucle conditionnelle (comme celle de C++). II ne 
s'agit pas d'une vraie boucle avec compteur (dans laquelle on se contenterait de citer le 
nom d'un compteur, sa valeur de debut et sa valeur de fin), meme si finalement elle est 
surtout utilisee ainsi. 

Dans ces conditions, le compilateur ne peut pas vous interdire de modifier la valeur 
d'un compteur (voire de plusieurs) dans la boucle. II est bien entendu vivement 
deconseille de le faire. 

Informations complementaires 

Le JDK 5.0 a introduit une nouvelle structure de boucle souvent nommee for... each. Elle 
ne s' applique toutefois qu'au parcours des elements d'une collection, d'un tableau ou 
d'une chalne et nous vous la presenterons par la suite dans ces differents contextes. 
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£3[f En C++ 

En C++, F instruction for fonctionne de maniere semblable. Mais le test porte sur la non- 
nullite de la valeur d'une expression numerique. Comme en C++, il existe un operateur 
virgule (que ne possede pas Java), cette expression peut en fait en juxtaposer plusieurs. 

6 Les instructions de branchement 
inconditionnel break et continue 

Ces instructions s'emploient principalement au sein de boucles. 

6.1 L'instruction break ordinaire 

Nous avons deja vu le role de break au sein du bloc regi par une instruction switch. Java vous 
autorise egalement a employer cette instruction dans une boucle {while, do... while ou for). 
Dans ce cas, elle sert a interrompre le deroulement de la boucle, en passant a l'instruction 
suivant la boucle. Bien entendu, cette instruction n'a d'interet que si son execution est condi- 
tionnee par un choix ; dans le cas contraire, en effet, elle serait executee des le premier tour 
de boucle, ce qui rendrait la boucle inutile. 

Voici un exemple illustrant le fonctionnement de break : 

public class Break 

{ public static void main (String args[ ] ) 
{ int i ; 

for (i=l ; i<=10 ; i++) 

{ System. out. println ("debut tour " + i) ; 
System. out. println ("bonjour") ; 
if (i==3) break ; 

System. out. println ("fin tour " + i) ; 

} 

System. out. println ("apres la boucle") ; 

} 

} 

debut tour 1 
bon j our 
fin tour 1 
debut tour 2 
bon j our 
fin tour 2 
debut tour 3 
bon j our 

apres la boucle 



Exemple a" utilisation a" instruction break 
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En cas de boucles imbriquees, l'instruction break fait sortir de la boucle la plus interne. 
De meme, si break apparait dans une instruction switch imbriquee dans une boucle, elle 
ne fait sortir que du switch. Toutefois, nous allons voir qu'une variante de cette instruction 
break permet de sortir de plus d'un niveau d'imbrication. 



L'instruction break ordinaire a F inconvenient de ne sortir que du niveau (boucle ou switch) le 
plus interne. Dans certains cas, cela s'avere insuffisant. Par exemple, on peut souhaiter sortir 
de deux boucles imbriquees. Un tel schema ne convient pas alors : 

while 
1 

for ( ) 

{ 

break ; // ce break nous branche 



En fait, Java permet de faire suivre ce mot-cle break d'une etiquette qui doit alors figurer 
devant la structure dont on souhaite sortir : 

repet : while 



Les etiquettes pouvant figurer devant une structure sont des identificateurs usuels. 

Informations complementaires 

L'instruction break ordinaire (sans etiquette) ne peut apparaitre que dans une boucle ou 
dans une instruction switch. En theorie, l'instruction break avec etiquette peut apparaitre 
n'importe ou. L etiquette correspondante doit simplement etre celle d'une instruction (ou 
eventuellement d'un bloc) contenant le bloc concerne. En voici deux exemples : 



6.2 L 



instruction break avec etiquette 



// <— ici 



for ( 



break repet ; // cette fois, ce break nous branche 



// <— ici 
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bloc : { // exemple 1 

repet : for (...) 
{ 

break repet ; 

break bloc ; 



test : if (...) // exemple 2 

{ 

break test ; 

} 

else 



} 



JJf En C++ 



En C++, l'instruction break ne permet de sortir que du niveau le plus interne. L'instruc- 
tion break avec etiquette n'existe pas. En revanche, on dispose de l'instruction goto. 

6.3 L'instruction continue ordinaire 

L'instruction continue permet de passer prematurement au tour de boucle suivant. En voici un 
premier exemple avec for : 

public class Continl 

{ public static void main (String args[ ] ) 
{ int i ; 

for (1=1 ; i<=5 ; i++) 

{ System. out. println ("debut tour " + i) ; 
if (i<4) continue ; 

System. out. println ("fin tour " + i) ; 

} 

System. out. println ("apres la boucle") ; 

} 

} 

debut tour 1 
debut tour 2 
debut tour 3 
debut tour 4 
fin tour 4 
debut tour 5 
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fin tour 5 
apres la boucle 

Exemple d 'instruction continue dans une boucle for 
Voici un second exemple avec do... while : 

public class Contin2 

{ public static void main (String args[ ] ) 
{ double x; 
do 

{ System. out. print ("donnez un flottant > 0 (0 pour finir) : ") ; 
x = Clavier. lireDouble () ; 

if (x < 0) { System. out .println (" ce nombre n' est pas > 0") ; 
continue ; 

} 

System. out. println (" Sa racine est " + Math.sqrt (x) ) ; 

} 

while (x != 0) ; 

} 

} 

donnez un flottant > 0 (0 pour finir) : 2.25 

Sa racine est 1 . 5 
donnez un flottant > 0 (0 pour finir) : -5 

ce nombre n' est pas > 0 
donnez un flottant > 0 (0 pour finir) : 2.0 

Sa racine est 1.4142135623730951 
donnez un flottant > 0 (0 pour finir) : 0 

Sa racine est 0 . 0 

Exemple d' instruction continue dans une boucle do... while 

Remarques 

1 Comme on s'y attend, lorsqu'elle est utilisee dans une boucle for, cette instruction conti- 
nue effectue bien un branchement sur 1'evaluation des expressions d' incrementation 
(notees increments dans la syntaxe Ac for), et non apres. 

2 En cas de boucles imbriquees, 1' instruction continue ne concerne que la boucle la plus 
interne. Mais comme nous allons le voir, une variante de cette instruction continue con- 
cerne plus d'un niveau d' imbrication. 
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6.4 Li 



instruction continue avec etiquette 



L' instruction continue ordinaire presentee ci-dessus presente V inconvenient de ne concerner 
que le niveau de boucle le plus interne. Dans certains cas, cela s'avere insuffisant. Par exem- 
ple, on peut souhaiter poursuivre l'execution d'une boucle englobante. Le schema suivant ne 
convient pas alors : 



} 

En fait, comme pour break, Java permet de faire suivre ce mot-cle continue d'une etiquette 
qui doit alors figurer devant la structure sur laquelle on souhaite boucler : 

repet : while (...) 

{ 

for (...) 

{ 



while (...) 



for (...) 



continue 



// ce continue nous fait poursuivre la boucle for 



// <— ici 



continue repet ; 



// ce continue nous fait poursuivre la boucle while 



} // <— ici 

Remarque 



Contrairement a l'instruction break avec etiquette, l'etiquette mentionnee dans l'instruc- 
tion continue doit obligatoirement etre celle d'une structure de boucle (sinon, elle n'aurait 
pas de signification). 
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Les classes et les objets 



Le premier chapitre a expose de facon theorique les concepts de base de la P.O.O., en particu- 
lier ceux de classe et d'objet. Nous avons vu que la notion de classe generalise celle de type : 
une classe comporte a la fois des champs (ou donnees) et des methodes. Quant a elle, la 
notion d'objet generalise celle de variable : un type classe donne permet de creer (on dit aussi 
instancier) un ou plusieurs objets du type, chaque objet comportant son propre jeu de don- 
nees. En P.O.O pure, on realise ce qu'on nomme 1' encapsulation des donnees ; cela signifie 
qu'on ne peut pas acceder aux champs d'un objet autrement qu'en recourant aux methodes 
prevues a cet effet. 

Dans les precedents chapitres, nous avons vu comment mettre en ceuvre une classe en Java. 
Mais toutes les classes que nous avons realisees etaient tres particulieres puisque : 

• nous ne creions aucun objet du type de la classe, 

• nos classes ne comportaient qu'une seule methode nommee main, et il ne s'agissait meme 
pas d'une methode au sens usuel car on pouvait executer ses instructions sans qu'on ait a 
preciser a quel objet elles devaient s'appliquer (cela en raison de la presence du mot-cle sta- 
tic). Nous vous avions d'ailleurs fait remarquer que cette methode main etait en fait sembla- 
ble au programme principal ou a la fonction principale des autres langages. 

Ici, nous allons aborder la notion de classe dans toute sa generalite, telle qu'elle apparait dans 
les concepts de P.O.O. 

Nous verrons tout d'abord comment definir une classe et l'utiliser en instanciant des objets 
du type correspondant, ce qui nous amenera a introduire la notion de reference a un objet. 
Nous etudierons ensuite l'importante notion de constructeur, methode appelee automatique- 
ment lors de la creation d'un objet. Puis nous examinerons comment se presente 1' affectation 
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d'objets et en quoi elle differe de celle des variables d'un type primitif. Nous preciserons les 
proprietes des methodes (arguments, variables locales..) avant d'aborder les possibilites de 
surdefinition. Nous presenterons alors le mode de transmission des arguments ou des valeurs 
de retour ; nous verrons plus precisement que les valeurs d'un type de base sont transmises 
par valeur, tandis que les valeurs de type objet le sont par reference. 

Nous etudierons ensuite ce que Ton nomme les champs et les methodes de classe et nous ver- 
rons que la methode main est de cette nature. 

Apres un exemple de classe possedant des champs eux-memes de type classe (objets mem- 
bres), nous vous presenterons la notion de classe interne (introduite seulement par Java 1.1). 
Nous terminerons sur la notion de paquetage. 

1 La notion de classe 

Nous allons commencer par vous exposer les notions de classe, d'objet et d'encapsulation a 
partir d'un exemple simple de classe. Par souci de clarte, celle-ci ne comportera pas de 
constructeur ; en pratique, la plupart des classes en disposent. Cette notion de constructeur 
sera exposee separement par la suite. 

Nous verrons d'abord comment creer une classe, c'est-a-dire ecrire les instructions permet- 
tant d'en definir le contenu (champs ou donnees) et le comportement (methodes). Puis nous 
verrons comment utiliser effectivement cette classe au sein d'un programme. 

1 .1 Definition d'une classe Point 

Nous vous proposons de definir une classe nommee Point, destinee a manipuler les points 
d'un plan. 

Rappelons le canevas general de definition d'une classe en Java, que nous avons deja utilise 
dans les precedents chapitres dans le seul but de contenir une fonction main : 

public class Point 

{ // instructions de definition des champs et des methodes de la classe 
} 

Nous reviendrons un peu plus loin sur le role exact de public. Pour l'instant, sachez simple- 
ment qu'il intervient dans Faeces d'autres classes a la classe Point. En son absence, Faeces a 
Point serait limite aux seules classes du meme paquetage 1 . 

Voyons maintenant comment definir le contenu de notre classe, en distinguant les champs des 
methodes. 



1 . Ce qui ne serait pas une limitation genante si vous vous en tenez a ['utilisation du paquetage par defaut (autre- 
ment dit, si vous ne faites pas appel a l'instruction package). 
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1.1.1 Definition des champs 

Nous supposerons ici qu'un objet de type Point sera represente par deux coordonnees entie- 
res. lis nous suffira de les declarer ainsi : 



Notez la presence du mot-cle private qui precise que ces champs x et y ne seront pas accessi- 
bles a l'exterieur de la classe, c'est-a-dire en dehors de ses propres methodes. Cela corres- 
pond a 1' encapsulation des donnees, dont on voit qu'elle n'est pas obligatoire en Java (elle est 
toutefois fortement recommandee). 

Ces declarations peuvent etre placees oil vous voulez a l'interieur de la definition de la classe, 
et pas necessairement avant les methodes. En general, on place les champs et methodes pri- 
vees a la fin. 

1.1.2 Definition des methodes 

Supposons que nous souhaitions disposer des trois methodes suivantes : 

• initialise pour attribuer des valeurs aux coordonnees d'un point, 

• deplace pour modifier les coordonnees d'un point, 

• affiche pour afficher un point ; par souci de simplicite, nous nous contenterons ici d'afficher 
les coordonnees du point. 

La definition d'une methode ressemble a celle d'une procedure ou d'une fonction dans les 
autres langages, ou encore a la definition de la methode main deja rencontree. Elle se com- 
pose d'un en-tete et d'un bloc. Ainsi, la definition de la methode initialise pourra se presenter 
comme ceci : 

public void initialise (int abs, int ord) 
{ x = abs ; 
y = ord ; 

} 

L' en-tete precise : 

• le nom de la methode, ici initialise ; 

• le mode d'acces : nous avons choisi public pour que cette methode soit effectivement utili- 
sable depuis un programme quelconque ; nous avons deja rencontre private pour des 
champs ; nous aurons l'occasion de revenir en details sur ces problemes d'acces ; 

• les arguments qui seront fournis a la methode lors de son appel, que nous avons choisi de 
nommer abs et ord ; il s'agit d' arguments muets, identiques aux arguments muets d'une 
fonction ou d'une procedure d'un autre langage ; 

• le type de la valeur de retour ; nous verrons plus tard qu'une methode peut fournir un re- 
sultat, c'est-a-dire se comporter comme ce que Ton nomme une fonction dans la plupart des 
langages (et aussi en mathematiques) ; ici, notre methode ne fournit aucun resultat, ce que 
Ton doit preciser en utilisant le mot-cle void. 



private int x ; 
private int y ; 



// abscisse 
// ordonnee 
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Si nous examinons maintenant le corps de notre methode initialise, nous y rencontrons une 
premiere affectation : 

x = abs ; 

Le symbole abs designe (classiquement) la valeur recue en premier argument. Quant a x, il ne 
s'agit ni d'un argument, ni d'une variable locale au bloc constituant la methode. En fait, x designe 
le champ x de Fobjet de type Point qui sera effectivement concerne par l'appel de initialise. Nous 
verrons plus loin comment se fait cette association entre un objet donne et une methode. 

La seconde affectation de initialise est comparable a la premiere. 

Les definitions des autres methodes de la classe Point ne presentent pas de difficulte 
particuliere. Voici la definition complete de notre classe Point : 



public class Point 

{ public void initialise (int abs, int ord) 
{ x = abs ; 
y = ord ; 

} 

public void deplace (int dx, int dy) 
{ x += dx ; 
y += dy ; 

} 

public void affiche () 

{ System. out .println ("Je suis un point de coordonnees " + x + " " + y) ; 
} 

private int x ; // abscisse 
private int y ; // ordonnee 



Definition d'une classe Point 



> 



Remarque 



Ici, tous les champs de notre classe Point etaient prives et toutes ses methodes etaient 
publiques. On peut disposer de methodes privees ; dans ce cas, elles ne sont utilisables 
que par d' autres methodes de la classe. On peut theoriquement disposer de champs 
publics mais c'est fortement deconseille. Par ailleurs, nous verrons qu'il existe egalement 
un mode d'acces dit "de paquetage", ainsi qu'un acces protege (protected) partiellement 
lie a 1' heritage. 



En C++, on distingue la declaration d'une classe de sa definition. Generalement, la pre- 
miere figure dans un fichier en-tete, la seconde dans un fichier source. Cette distinction 
n' existe pas en Java. 
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1 .2 Utilisation de la classe Point 

Comme on peut s'y attendre, la classe Point va permettre d'instancier des objets de type Point 
et de leur appliquer a volonte les methodes publiques initialise, deplace et affiche. 

Bien entendu, cette utilisation ne pourra se faire que depuis une autre methode puisque, en 
Java, toute instruction appartient toujours a une methode. Mais il pourra s'agir de la methode 
particuliere main, et c'est ainsi que nous procederons dans notre exemple de programme 
complet. 

1.2.1 La demarche 

A l'interieur d'une methode quelconque, une declaration telle que : 

Point a ; 

est tout a fait correcte. Cependant, contrairement a la declaration d'une variable d'un type 
primitif (comme int n ;), elle ne reserve pas d'emplacement pour un objet de type Point, mais 
seulement un emplacement pour une reference a un objet de type Point. L' emplacement pour 
l'objet proprement dit sera alloue sur une demande explicite du programme, en faisant appel 
a un operateur unaire nomme new. Ainsi, l'expression : 

new Point () // attention a la presence des parentheses () 

cree un emplacement pour un objet de type Point et fournit sa reference en resultat. Par exem- 
ple, on pourra proceder a cette affectation : 

a = new Point () ; // cree d'un objet de type Point et place sa reference dans a 
La situation peut etre schematisee ainsi : 




Pour l'instant, les champs x et y n'ont apparemment pas encore recu de valeur (on verra plus 
tard qu'en realite, ils ont ete initialises par defaut a 0). 

Une fois qu'une reference a un objet a ete convenablement initialisee, on peut appliquer 
n'importe quelle methode a l'objet correspondant. Par exemple, on pourra appliquer la 
methode initialise a l'objet reference par a, en procedant ainsi : 

a. initialise (3, 5) ; // appelle la methode initialise du type Point 
// en 1' appliquant a 1' objet de reference a, et 
//en lui transmettant les arguments 3 et 5 

Si on fait abstraction du prefixe a, cet appel est analogue a un appel classique de fonction tel 
qu'on le rencontre dans la plupart des langages. Bien entendu, c'est ce prefixe qu va preciser 
a la methode sur quel objet elle doit effectivement operer. Ainsi, 1' instruction x = abs de la 
methode initialise placera la valeur recue pour abs (ici 3) dans le champ x de l'objet a. 
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Remarque 



Nous dirons que a est une variable de type classe. Nous ferons souvent l'abus de langage 
consistant a appeler objet a l'objet dont la reference est contenue dans a. 



En C++, la declaration d'un objet entraine toujours la reservation d'un emplacement 
approprie (comme pour un type de base), contrairement a Java qui reserve un emplace- 
ment pour un type primitif, mais seulement une reference pour un objet. En revanche, en 
C++, on peut instancier un objet de deux manieres differentes : par sa declaration (objet 
automatique) ou par l'operateur new (objet dynamique). Dans ce dernier cas, on obtient 
en resultat une adresse qu'on manipule par le biais d'un pointeur, ce dernier jouant un peu 
le role de la reference de Java. Le fait que Java ne dispose que d'un seul mode d'instan- 
ciation (correspondant aux objets dynamiques de C++) contribue largement a la clarte des 
programmes. 

1.2.2 Exemple 

Comme nous l'avons deja dit, nous pouvons employer notre classe Point depuis toute 
methode d'une autre classe, ou depuis une methode main. Cette derniere doit de toute facon 
etre elle aussi une methode (statique) d'une classe. A priori, nous pourrions faire de main une 
methode de notre classe Point. Mais la demarche serait alors trop particuliere : nous prefe- 
rons done qu'elle appartienne a une autre classe. Voici un exemple complet d'une classe 
nommee TstPoint contenant (seulement) une fonction main utilisant notre classe Point : 

public class TstPoint 

{ public static void main (String args[ ] ) 



O 1 " 



En C++ 



{ Point a ; 



a = new Point ( ) ; 



a. initialise (3, 5) ; 
a.deplace (2, 0) ; 



a.afficheO 
a.afficheO 



Point b = new Point () 
b. initialise (6, 8) ; 



b . af f iche ( ) 



Je suis un point de coordonnees 3 5 
Je suis un point de coordonnees 5 5 
Je suis un point de coordonnees 6 8 



Exemple a" utilisation de la classe Point 
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Notez que nous vous fournissons un exemple d' execution, bien que pour 1' instant nous ne 
vous ayons pas encore precise comment executer un programme forme de plusieurs classes 
(ici TstPoint et Point), ce que nous ferons au paragraphe suivant. 

\^^~ Remarque 

Dans notre classe Point, les champs x et y ont ete declares prives. Une tentative d'utilisa- 
tion directe, en dehors des methodes de Point, conduirait a une erreur de compilation. Ce 
serait notamment le cas si, dans notre methode main, nous cherchions a introduire des 
instructions telles que : 

a.x = 5 ; // erreur : x est prive 

System. out. println ("ordonnee de a " + a.y) ; // erreur : y est prive 

1 .3 Mise en oeuvre d'un programme comportant 
plusieurs classes 

Jusqu'ici, nos programmes etaient formes d'une seule classe. II suffisait de la compiler et de 
lancer l'execution. Avec plusieurs classes, les choses sont legerement differentes et plusieurs 
demarches sont possibles. Nous commencerons par examiner la plus courante, a savoir utili- 
ser un fichier source par classe. 

1.3.1 Un fichier source par classe 

Vous aurez sauvegarde le source de la classe Point dans un fichier nomme Point.java. Sa 
compilation donnera naissance au fichier de byte codes Point.class. Bien entendu, il n'est pas 
question d' executer directement ce fichier puisque la machine virtuelle recherche une fonc- 
tion main. 

En ce qui concerne la classe TstPoint, vous aurez la aussi sauvegarde son source dans un 
fichier TstPoint.java. Pour le compiler, il faut : 

• que Point.class existe (ce qui est le cas si Point.java a ete compile sans erreurs), 

• que le compilateur ait acces a ce fichier ; selon l'environnement utilise, des problemes de 
localisation du fichier peuvent se manifester ; la notion de paquetage peut aussi intervenir 
mais si, comme nous vous l'avons deja conseille, vous n'y avez pas fait appel, aucun pro- 
bleme ne se posera 1 . 

Une fois compile TstPoint, il ne restera plus qu'a executer le fichier TstPoint.class ainsi 
obtenu. 



1. Nous attirons a nouveau votre attention sur les "generateurs automatiques" de certains environnements qui 
introduisent d' office une instruction package xxx et qu'il est preferable de supprimer. 
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Bien entendu, la demarche a utiliser pour proceder a ces differentes etapes depend de l'envi- 
ronnement utilise. S'il s'agit du JDK de SUN, il vous suffira d'utiliser successivement ces 
commandes : 

javac Point. java 
javac TstPoint. java 
java TstPoint 

Avec un environnement de developpement integre, les choses se derouleront de facon plus ou 
moins automatique. Souvent, il vous suffira de definir un "fichier projet" contenant simple - 
ment les noms des fichiers source concernes {Point.java et TstPoint.java). 

1.3.2 Plusieurs classes dans un meme fichier source 

Jusqu'ici, nous avons : 

• declare chaque classe avec l'attribut public (ne confondez pas ce droit d'acces a une classe 
avec le droit d'acces a ses champs ou methodes, meme si certains mots-cles sont communs) ; 

• place une seule classe par fichier source. 

En fait, Java n'est pas tout a fait aussi strict. II vous impose seulement de respecter les con- 
traintes suivantes : 

• un fichier source peut contenir plusieurs classes mais une seule doit etre publique ; 

• la classe contenant la methode main doit obligatoirement etre publique, afin que la machine 
virtuelle y ait acces ; 

• une classe n'ayant aucun attribut d'acces 1 reste accessible a toutes les classes du meme pa- 
quetage done, a fortiori, du meme fichier source. 

Ainsi, tant que nous ne cherchons pas a utiliser Point en dehors de TstPoint, nous pouvons 
regrouper ces deux classes TstPoint et Point a l'interieur d'un seul fichier, en procedant ainsi 
(nous avons change le nom de la classe TstPoint en TstPntI) : 

public class TstPnt2 

{ public static void main (String args[ ] ) 
{ Point a ; 

a = new Point ( ) ; 
a. initialise (3, 5) ; 
a.affiche() ; 
a.deplace(2, 0) ; 

a. affiche() ; 

Point b = new Point ( ) ; 

b. initialise (6, 8) ; b.afficheO ; 

} 

} 



1 . On verra que l'attribut d'acces d'une classe ne peut prendre que deux valeurs : inexistant (acces de paquetage) 
ou public. 
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class Point 

{ public void initialise (int abs, int ord) 
{ x = abs ; 
y = ord ; 

public void deplace (int dx, int dy) 
{ x += dx ; 
y += dy ; 

public void affiche () 

{ System. out. println ("Je suis un point de coordonnees " + x + " " + y) ; 

private int x ; // abscisse 
private int y ; // ordonnee 

} 



Par souci de clarte, il nous arrivera souvent de fournir des exemples de programmes complets 
sous cette forme meme si, en pratique, vous serez generalement amene a dissocier vos classes 
et a les rendre publiques pour pouvoir les reutiliser le plus largement possible. 



1 Vous voyez que la classe Clavier proposee au paragraphe 4.1 du chapitre 2 peut etre 
exploitee de cette maniere. Autrement dit, il suffit de la recopier dans tout programme y 
faisant appel, en supprimant simplement le mot-cle public. 

2 En theorie, rien ne vous empeche de faire de la methode main une methode de la classe 
Point. II serait ainsi possible d'ecrire un programme reduit a une seule classe et conte- 
nant a la fois sa definition et son utilisation. Mais dans ce cas, la methode main aurait 
acces aux champs prives de la classe, ce qui ne correspond pas aux conditions usuelles 
d'utilisation : 

class Point 

{ // methodes initialise, deplace et affiche 
public static void main (String argsf ] ) 
{ Point a ; 

a = new Point ( ) ; 



Les classes TstPnt2 et Point dans un seul fichier source 




Remarques 



a.x = 



// autorise ici puisque main est une methode de Point 



private int x, y ; 



II n'est done pas judicieux d'utiliser cette possibilite pour faire de la methode main une 
sorte de test de la classe, meme si cette demarche est parfois utilisee dans la litterature 
sur Java. 
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3 Lorsque plusieurs classes figurent dans un meme fichier source, la compilation cree un 
fichier .class par classe. 

2 La notion de constructeur 

2.1 Generates 

Dans l'exemple de classe Point du paragraphe 1.1, il est necessaire de recourir a la methode 
initialise pour attribuer des valeurs aux champs d'un objet de type Point. Une telle demarche 
suppose que l'utilisateur de l'objet fera effectivement l'appel voulu au moment opportun. En 
fait, la notion de constructeur vous permet d'automatiser le mecanisme d' initialisation d'un 
objet. En outre, cette initialisation ne sera pas limitee a la mise en place de valeurs initiales ; 
il pourra s'agir de n'importe quelles actions utiles au bon fonctionnement de l'objet. 

Un constructeur n'est rien d' autre qu'une methode, sans valeur de retour, portant le meme 
nom que la classe. II peut disposer d'un nombre quelconque d' arguments (eventuellement 
aucun). 

2.2 Exemple de classe comportant un constructeur 

Considerons la classe Point presentee au paragraphe 1.1 et transformons simplement la 
methode initialise en un constructeur en la nommant Point. La definition de notre nouvelle 
classe se presente alors ainsi : 

public class Point 

{ public Point (int abs, int ord) // constructeur 
{ x = abs ; 
y = ord ; 

} 

public void deplace (int dx, int dy) 
{ x += dx ; 
y += dy ; 

} 

public void affiche () 

{ System. out .println ("Je suis un point de coordonnees " + x + " " + y) ; 
} 

private int x ; // abscisse 
private int y ; // ordonnee 

} 

Definition a" une classe Point munie d'un constructeur 
Comment utiliser cette classe ? Cette fois, une instruction telle que : 

Point a = new Point ( ) ; 
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ne convient plus : elle serait refusee par le compilateur. En effet, a partir du moment oil une 
classe dispose d'un constructeur, il n'est plus possible de creer un objet sans l'appeler. Ici, 
notre constructeur a besoin de deux arguments. Ceux-ci doivent obligatoirement etre fournis 
lors de la creation, par exemple : 

Point a = new Point ( 1 , 3 ) ; 

A titre d' exemple, voici comment on pourrait adapter le programme du paragraphe 1.3 en uti- 
lisant cette nouvelle classe Point : 

public class TstPnt3 

{ public static void main (String args[ ] ) 
{ Point a ; 

a = new Point (3, 5) ; 
a.afficheO ; 
a.deplace(2, 0) ; 

a. afficheO ; 

Point b = new Point (6, 8) ; 

b. affichef) ; 

} 

} 

class Point 

{ public Point (int abs, int ord) // constructeur 
{ x = abs ; 
y = ord ; 

} 

public void deplace (int dx, int dy) 
{ x += dx ; 
y += dy ; 

} 

public void affiche () 

{ System. out. println ("Je suis un point de coordonnees " + x + " " + y) ; 
} 

private int x ; // abscisse 
private int y ; // ordonnee 

J 

Je suis un point de coordonnees 3 5 
Je suis un point de coordonnees 5 5 
Je suis un point de coordonnees 6 8 

Exemple d' utilisation a" une classe Point munie d'un constructeur 

2.3 Quelques regies concernant les constructeurs 

1 Par essence, un constructeur ne fournit aucune valeur. Dans son en-tete, aucun type ne 
doit figurer devant son nom. Meme la presence (logique) de void est une erreur : 
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class True 
{ 

public void True () // erreur de compilation : void interdit ici 

{ 

} 

} 

2 Une classe peut ne disposer d'aucun constructeur (e'etait le cas de notre premiere classe 
Point). On peut alors instancier des objets comme s'il existait un constructeur par defaut sans 
arguments (et ne faisant rien) par des instructions telles que : 

Point a = new Point () ; // OK si Point n' a pas de constructeur 

Mais des qu'une classe possede au moins un constructeur (nous verrons plus loin qu'elle peut 
en comporter plusieurs), ce pseudo-constructeur par defaut ne peut plus etre utilise, comme le 
montre cet exemple : 

class A 

{ public A(int) { } // constructeur a un argument int 



A al = new A(5) ; // OK 

A a2 = new A() ; // erreur 

On notera que l'emploi d'un constructeur sans arguments ne se distingue pas de celui du 
constructeur par defaut. Si, pour une classe Tdonnee, l'instruction suivante est acceptee : 

T t = new T() ; 

cela signifie simplement que : 

• soit Tne dispose d'aucun constructeur, 

• soit T dispose d'un constructeur sans arguments. 

3 Un constructeur ne peut pas etre appele directement depuis une autre methode. Par exem- 
ple, si Point dispose d'un constructeur a deux arguments de type int : 

Point a = new Point (3, 5) ; 
a. Point (8, 3) ; // interdit 

4 Un constructeur peut appeler un autre constructeur de la meme classe. Cette possibilite 
utilise la surdefinition des methodes et necessite Putilisation du mot-cle super ; nous en par- 
lerons plus loin. 

5 Un constructeur peut etre declare prive (private). Dans ce cas, il ne pourra plus etre 
appele de l'exterieur, e'est-a-dire qu'il ne pourra pas etre utilise pour instancier des objets : 

class A 

{ private A() { } // constructeur prive sans arguments 

} 

A a() ; // erreur : le constructeur correspondant A() est prive 1 
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En fait, cette possibility n'aura d'interet que si la classe possede ail moins un autre construc- 
teur public faisant appel a ce constructeur prive, qui apparaitra alors comme une methode de 
service. 

2.4 Construction et initialisation d'un objet 

Dans nos precedents exemples, le constructeur initialisait les differents champs prives de 
l'objet. En fait, contrairement a ce qui se passe pour les variables locales, les champs d'un 
objet sont toujours initialises par defaut. En outre, il est possible de leur attribuer explicite- 
ment une valeur au moment de leur declaration. En definitive, la creation d'un objet entraine 
toujours, par ordre chronologique, les operations suivantes : 

• une initialisation par defaut de tous les champs de l'objet, 

• une initialisation explicite lors de la declaration du champ, 

• F execution des instructions du corps du constructeur. 

2.4.1 Initialisation par defaut des champs d'un objet 

Des qu'un objet est cree, et avant 1' appel du constructeur, ses champs sont initialises a une 
valeur par defaut "nulle" ainsi definie : 



Type du champ 


Valeur par defaut 


boolean 
char 

entier (byte, short, int, long) 
flottant (float, double) 
objet 


false 

caractere de code nul 
0 

O.f ou 0. 
null 



Initialisation par defaut des champs d'un objet 



Comme on peut s'y attendre, un champ d'une classe peut tres bien etre la reference a un 
objet. Dans ce cas, cette reference est initialisee a une valeur conventionnelle notee null sur 
laquelle nous reviendrons. 

2.4.2 Initialisation explicite des champs d'un objet 

Une variable locale peut etre initialisee lors de sa declaration. II en va de meme pour un 
champ. Considerons : 



1. N'oubliez pas que des qu'une classe dispose d'un constructeur, on ne peut plus recourir au pseudo-construc- 
teur par defaut. 
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class A 

{ public A (...) { } // constructeur de A 



private int n = 10 ; 
private int p ; 

} 

L' instruction suivante : 

A a = new A (...) ; 

entraine successivement : 

• F initialisation (implicite) des champs n et p de a a 0, 

• l'initialisation (explicite) du champ n a la valeur figurant dans sa declaration, soit 10, 

• F execution des instructions du constructeur. 

Comme celle d'une variable locale, une initialisation de champ peut theoriquement compor- 
ter non seulement une constante ou une expression constante, mais egalement n'importe 
quelle expression (pour peu qu'elle soit calculable au moment voulu). En voici un exemple : 

class B 
{ 

private int n = 10 ; 

private int p = n+2 ; 

} 

Notez que si Ton inverse Fordre des declarations de n et de p, on obtient une erreur de com- 
pilation car n n'est pas encore connu lorsqu'on rencontre l'expression d'initialisation n+2 : 

class B 
{ 

private int p = n+2 ; / / erreur : n n' est pas encore connu ici 
private int n = 10 ; 

} 

En general, il n'est guere prudent d'utiliser ce genre de possibilite car elle ne permet pas un 
rearrangement des declarations de champs. De meme, il n'est guere raisonnable d'initialiser 
un champ de cette maniere, pourtant acceptee par Java : 

class C 
{ 

private int n = Clavier . lirelnt () ; 

} 

2.4.3 Appel du constructeur 

Le corps du constructeur n'est execute qu'apres l'initialisation par defaut et l'initialisation 
explicite. Voici un exemple d'ecole dans lequel cet ordre a de l'importance : 

public class Init 

{ public static void main (String args[ ] ) 

{ A a = new A() ; // ici a.n vaut 5, a.p vaut 10, mais a.np vaut 200 
a.affiche() ; 

} 

) 
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class A 

{ public A() 

{ // ici, n vaut 20, p vaut 10 et np vaut 0 

np = n * p ; 

n = 5 ; 

} 

public void af f iche ( ) 

{ System. out. println ("n = " + n + ", p = " + p + ", np = " + np) ; 
} 

private int n = 20, p = 10 ; 
private int np ; 

) 



n = 5, p = 10, np = 200 

Quand I'ordre des differentes initialisations a de V importance 

En pratique, on aura interet a s'arranger pour que l'utilisateur de la classe n'ait pas a s'inter- 
roger sur I'ordre chronologique exact de ces differentes operations. Autre ment dit, dans la 
mesure du possible, on veillera a ne pas meler les differentes possibilites d' initialisation d'un 
meme champ et a limiter les dependances. Ici, il serait beaucoup plus simple de proceder 
ainsi : 

class A 

{ public A() 

{ n = 5 ; p = 10 ; 
np = n * p ; 

} 



} 

D'une maniere generale, les possibilites offertes par le constructeur sont beaucoup plus lar- 
ges que les initialisations explicites, ne serait-ce que parce que seul le constructeur peut 
recuperer les arguments fournis a new. Sauf cas particulier, il est done preferable d'effectuer 
les initialisations dans le constructeur. 

2.4.4 Cas des champs declares avec I'attribut final 

Nous avons deja vu qu'on pouvait declarer une variable locale avec l'attribut jSna/. Dans ce 
cas, sa valeur ne devait etre definie qu'une seule fois. Cette possibilite se transpose aux 
champs d'un objet. Examinons quelques exemples, avant de degager les regies generates. 

Exemple 1 

class A 
{ 

private final int n = 20 ; //la valeur de n est definie dans sa declaration 



} 
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Ici, la valeur de n est une constante fixee dans sa declaration. Notez que tous les objets de 
type A possederont un champ n contenant la valeur 10 (nous verrons plus loin qu'il serait plus 
pratique et plus economique de faire de n un champ de classe en le declarant avec l'attribut 
static). 

Exemple 2 

class A 
{ public A() 
{ n = 10 ; 

} 

private final int n ; 

} 

Ici, la valeur de n est definie par le constructeur de A. On a affaire a une initialisation tardive, 
comme pour une variable locale. 

Ici encore, telle que la classe A a ete definie, tous les objets de type A auront un champ n com- 
portant la meme valeur. 

Exemple 3 

Considerez maintenant : 

class A 

{ public A (int nn) 
{ n = nn ; 

} 

private final int n ; 

} 

Cette fois, les differents objets de type A pourront posseder des valeurs de n differentes. 



Quelques regies 

Comme une variable locale, un champ peut done etre declare avec l'attribut final, afin 
d'imposer qu'il ne soit initialise qu'une seule fois. Toute tentative de modification ulterieure 
conduira a une erreur de compilation. Mais, alors qu'une variable locale pouvait etre initiali- 
see tardivement n'importe oil dans une methode, un champ declare final doit etre initialise au 
plus tard par un constructeur (ce qui est une bonne precaution). 

D'autre part, il n'est pas permis de compter sur l'initialisation par defaut d'un tel champ. Le 
schema suivant conduira a une erreur de compilation : 

class A 
{ A() 

{ // ici, on ne donne pas de valeur a n 
} 

private final int n ; // ici, non plus — > erreur de compilation 

) 
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Remarques 

1 Le champ final de notre exemple etait prive mais, bien entendu, il pourrait etre public. 

2 Nous verrons que le mot-cle final peut s'appliquer a une methode avec une signification 
totalement differente. 

Informations complementaires 

Outre les possibilites d' initialisation explicite des champs, Java permet d'introduire, dans 
la definition d'une classe, un ou plusieurs blocs d' instructions dits "blocs d' initialisation", 
lis seront executes dans l'ordre oil ils apparaissent apres les initialisations explicites et 
avant l'appel du constructeur. Cette possibilite n'est pas indispensable (on peut faire la 
meme chose dans un constructeur !). Elle risque meme de nuire a la clarte du programme. 
Son usage est deconseille. 

3 Elements de conception des classes 

Ce paragraphe vous propose quelques elements fondamentaux pour la bonne conception de 
vos classes. 

3.1 Les notions de contrat et d'implementation 

L' encapsulation des donnees n'est pas obligatoire en Java. II est cependant vivement con- 
seille d'y recourir systematiquement en declarant tous les champs prives. 

En effet, une bonne conception orientee objets s'appuie generalement sur la notion de con- 
trat, qui revient a considerer qu'une classe est caracterisee par un ensemble de services 
definis par : 

• les en-tetes de ses methodes publiques 1 , 

• le comportement de ces methodes. 

Le reste, c'est-a-dire les champs et les methodes prives ainsi que le corps des methodes 
publiques, n'a pas a etre connu de Futilisateur de la classe. II constitue ce que Ton appelle 
souvent V implementation de la classe. 

En quelque sorte, le contrat definit ce que fait la classe tandis que son implementation precise 
comment elle le fait. 

II est clair que le grand merite de 1' encapsulation des donnees (private) est de permettre au 
concepteur d'une classe d'en modifier 1' implementation, sans que Futilisateur n'ait a modi- 
fier les programmes qui l'exploitent. 



1. Dans certains langages, on parle d'interface, mais en Java ce terme possede une autre signification. 
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On notera cependant que les choses ne seront entierement satisfaisantes que si le contrat ini- 
tial est respecte. Or s'il est facile de respecter les en-tetes de methodes, il peut en aller diffe- 
remment en ce qui concerne leur comportement. En effet, ce dernier n'est pas inscrit dans le 
code de la classe elle-meme, mais simplement specifie par le concepteur 1 . II va de soi que 
tout depend alors de la qualite de sa specification et de sa programmation. 

3.2 Typologie des methodes d'une classe 

Parmi les differentes methodes que comporte une classe, on a souvent tendance a distinguer : 

• les constructeurs ; 

• les methodes d'acces (en anglais accessor) qui fournissent des informations relatives a l'etat 
d'un objet, c'est-a-dire aux valeurs de certains de ses champs (generalement prives), sans 
les modifier ; 

• les methodes d'alteration (en anglais mutator) qui modifient l'etat d'un objet, done les va- 
leurs de certains de ses champs. 

On rencontre souvent 1' utilisation de noms de la forme getXXXX pour les methodes d'acces 
et setXXXX pour les methodes d'alteration, y compris dans des programmes dans lesquels les 
noms de variables sont francises. Par exemple, la classe Point du paragraphe annexe 2.2 pour- 
rait etre completee par les methodes suivantes : 

public int getX { return x ; } // getX ou encore getAbscisse 

public int getY { return y ; } // getY ou encore getOrdonnee 

public void setx (int abs) { x = abs ; } // setx ou encore setAbscisse 

public void setY (int ord) { x = ord ; } // setY ou encore setOrdonnee 

public void setPosition (int abs, int ord) 

{ x = abs ; y = ord ; 

} 

Notez qu'il n'est pas toujours prudent de pre voir une methode d'alteration pour chacun des 
champs prives d'un objet. En effet, il ne faut pas oublier qu'il doit toujours etre possible de 
modifier F implementation d'une classe de maniere transparente pour son utilisateur. Meme 
sur les petits exemples precedents, des difficultes pourraient apparaitre si nous souhaitions 
representer un point (de facon privee), non plus par ses coordonnees cartesiennes, mais par 
ses coordonnees polaires. Dans ce cas, en effet, la methode setX ne serait plus utilisable 
seule ; elle ne pourrait l'etre que conjointement a setY. II pourrait alors etre preferable de ne 
conserver que la methode setPosition. 



1 . Imaginez une methode deplace implementee ainsi 
void deplace (int dx, int dy) j x +=dy ; y+=dx; } 
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4 Affectation et comparaison d'objets 

Nous avons etudie le role de Foperateur d' affectation sur des variables d'un type primitif. Par 
ailleurs, nous venons de voir qu'il existe des variables de type classe, destinees a contenir des 
references sur des objets. Comme on peut s'y attendre, ces variables pourront etre soumises a 
des affectations. Mais celles-ci portent sur les references et non sur les objets eux-memes, ce 
qui modifie quelque peu la semantique (signification) de F affectation. C'est ce que nous 
allons examiner a partir de deux exemples. Nous donnerons ensuite quelques informations 
concernant F initialisation de references. Enfin, nous montrerons le role des operateurs == et 
!= lorsqu'on les applique a des references. 

4.1 Premier exemple 

Supposons que nous disposions d'une classe Point possedant un constructeur a deux argu- 
ments entiers et considerons ces instructions : 

Point a, b ; 

a = new Point (3, 5) ; 
b = new Point (2, 0) ; 

Apres leur execution, on aboutit a cette situation : 



a 



b 




3 
5 



2 
0 



Executons maintenant Faffectation : 

a = b ; 
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Celle-ci recopie simplement dans a la reference contenue dans b, ce qui nous conduit a : 



3 
5 



a 



b 




2 
0 



Dorenavant, a et b designent le meme objet, et non pas deux objets de meme valeur. 

4.2 Second exemple 

Considerons les instructions suivantes : 

Point a, b, c ; 

a = new Point (1, 10) ; 
b = new Point (2, 20) ; 
c = a ; 
a = b ; 
b = c ; 

Apres leur execution, on aboutit a cette situation : 



a 



b 



c 




10 



2 

20 



Notez bien qu'il n'existe ici que deux objets de type Point et trois variables de type Point 
(trois references, dont deux de meme valeur). 
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Remarque 

Le fait qu'une variable de type classe soit une reference et non une valeur aura aussi des 
consequences dans la transmission d'un objet en argument d'une methode. 



4.3 Initialisation de reference et reference nulle 

Nous avons deja vu qu'il n'est pas possible de definir une variable locale d'un type primitif 
sans l'initialiser. La regie se generalise aux variables locales de type classe. Considerez cet 
exemple utilisant une classe Point disposant d'une methode affiche : 

public static void main (String argsf ] ) 
{ Point p ; // P est locale a main 

p. affiche () ; // erreur de compilation : p n' a pas encore recu de valeur 

} 

En revanche, comme nous l'avons vu au paragraphe 2.4, un champ d'un objet est toujours 
initialise soit implicitement a une valeur dite nulle 1 , soit explicitement, soit au sein du cons- 
tructeur. Cette regie s' applique egalement aux champs de type classe 2 , pour lesquels cette 
valeur nulle correspond a une valeur particuliere de reference notee par le mot-cle null. 

Conventionnellement, une telle reference ne designe aucun objet. Elle peut etre utilisee dans 
une comparaison, comme dans cet exemple (on suppose que Point est une classe) : 

class A 

{ public void f () 
{ 

if (p==nul) //on compare la valeur de p a la valeur null 

} 

private Point p ; 

} 

La valeur null peut aussi etre affectee explicitement a une variable ou un champ de type 
classe. En general, cela ne presentera guere d'interet. En tout cas, il ne faut pas se reposer la- 
dessus pour eviter de tester une reference qui risque de ne pas etre definie ou d'etre nulle. En 
effet, alors qu'une reference non definie est detectee en compilation, une reference nulle n'est 
detectee qu'au moment ou Ton cherche a l'employer pour lui appliquer une methode, done a 
l'execution. On obtient une exception NullPointerException qui, si elle n'est pas traitee 
(comme nous apprendrons a le faire au chapitre 10, conduit a un arret de l'execution. Voyez 
cet exemple : 



1 . Exception faite des champs declares avec 1' attribut final qui, comme on l'a vu, doivent recevoir explicitement 
une valeur. 

2. Nous en verrons des exemples au paragraphe 11. 
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public static void main (String args[ ] ) 

{ Point p = null ; // p est locale a main et initialisee a null 
p.afficheO ; // erreur d' execution cette fois 



4.4 La notion de clone 



Nous venons de voir que 1' affectation de variables de type objet se limite a la recopie de refe- 
rences. Elle ne provoque pas la recopie de la valeur des objets. Si on le souhaite, on peut bien 
entendu effectuer explicitement la recopie de tous les champs d'un objet dans un autre objet 
de meme type. Toutefois, si les donnees sont convenablement encapsulees, il n'est pas possi- 
ble d'y acceder directement. On peut songer a s'appuyer sur l'existence de methodes d'acces 
et d'alteration de ces champs prives. Cependant, rien ne permet d'etre certain que ces metho- 
des forment un ensemble coherent et complet (nous avons deja evoque au paragraphe 3.2 les 
difficultes a concilier completude et transparence de F implementation). Quand bien meme ce 
serait le cas, leur utilisation pour la recopie complete d'un objet necessiterait malgre tout une 
bonne connaissance de son implementation. 

En fait, la demarche la plus realiste consiste plutot a prevoir dans la classe correspondante 
une methode destinee a fournir une copie de F objet concerne, comme dans cet exemple 1 : 

class Point 

{ public Point (int abs, int ord) { x = abs ; y = ord ; } 

public Point copie () // renvoie une reference a un Point 

{ Point p = new Point (x, y) ; 

p.x = x ; p.y = y ; 

return p ; 

} 

private int x, y ; 



Cette demarche est utilisable tant que la classe concernee ne comporte pas de champs de type 
classe. Dans ce cas, il faut decider si leur copie doit, a son tour, porter sur les objets referen- 
ces plutot que sur les references. 

On voit apparaitre la distinction usuelle entre : 

• la copie superficielle d'un objet : on se contente de recopier la valeur de tous ses champs, y 
compris ceux de type classe, 



Point a = new Point ( 1 , 2 ) 
Point b = a . copie ( ) ; 



// b est une copie conforme de a 



1 . Nous reviendrons plus loin sur la possibility pour une methode de renvoyer une reference a un objet et nous 
verrons qu'aucun probleme particulier ne se pose (contrairement a ce qui se passe dans d'autres langages com- 
me C++). 
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• la copie profonde d'un objet : comme precedemment, on recopie la valeur des champs d'un 
type primitif mais pour les champs de type classe, on cree une nouvelle reference a un autre 
objet du meme type de me me valeur. 

Comme on s'en doute, la copie profonde peut etre recursive et pour etre menee a bien, elle 
demande la connaissance de la structure des objets concernes. 

La demarche la plus rationnelle pour traiter cette copie profonde qu'on nomme clonage en 
Java, consiste a faire en sorte que chaque classe concernee par l'eventuelle recursion dispose 
de sa propre methode. 

GM nC++ 

En C++, F affectation realise une copie superficielle des objets (rappelons qu'il ne s'agit 
pas, comme en Java, d'une copie de references). On peut redefinir l'operateur d'affecta- 
tion (pour une classe donnee) et lui donner la signification de son choix ; en general, on le 
transforme en une copie profonde. 

En outre, il existe en C++ un constructeur particulier dit constructeur par recopie qui 
joue un role important dans les transmissions d'objets en argument d'une methode. Par 
defaut, il effectue lui aussi une copie superficielle ; il peut egalement etre redefini pour 
realiser une copie profonde. 

4.5 Comparaison d'objets 

Les operateurs == et != s'appliquent theoriquement a des objets. Mais comme ils portent sur 
les references elles-memes, leur interet est tres limite. Ainsi, avec : 

Point a, b ; 

L expression a == b est vraie uniquement si a et b font reference a un seul et meme objet, et 
non pas seulement si les valeurs des champs de a et b sont les memes. 

5 Le ramasse-miettes 

Nous avons vu comment un programme peut donner naissance a un objet en recourant a 
Foperateur new 1 . A sa rencontre, Java alloue un emplacement memoire pour Fobjet et l'ini- 
tialise (implicitement, explicitement, par le constructeur). 

En revanche, il n'existe aucun operateur permettant de detruire un objet dont on n'aurait plus 
besoin. 



1. II peut s'agir d'un recours indirect comme dans a.copie(). 



Les classes et les objets 

Chapitre 6 

En fait, la demarche employee par Java est un mecanisme de gestion automatique de la 
memoire connu sous le nom de ramassse-miettes (en anglais Garbage Collector). Son prin- 
cipe est le suivant : 

• A tout instant, on connait le nombre de references a un objet donne. On notera que cela n'est 
possible que parce que Java gere toujours un objet par reference. 

• Lorsqu'il n'existe plus aucune reference sur un objet, on est certain que le programme ne 
pourra plus y acceder. II est done possible de liberer F emplacement correspondant, qui 
pourra etre utilise pour autre chose. Cependant, pour des questions d'efficacite, Java n' im- 
pose pas que ce travail de recuperation se fasse immediatement. En fait, on dit que Fobjet 
est devenu candidat au ramasse-miettes. 

Remarque 

On peut creer un objet sans en conserver la reference, comme dans cet exemple artificiel : 

(new Point (3, 5) ) .afficheO ; 

Ici, on cree un objet dont on affiche les coordonnees. Des la fin de l'instruction, l'objet 
(qui n'est pas reference) devient candidat au ramasse-miettes. 

£Jr En C++ 

L'operateur delete permet de detruire un objet (dynamique) cree par new. Les objets auto- 
matiques sont automatiquement detruits lors de la sortie du bloc correspondant. La des- 
truction d'un objet (dynamique ou automatique) entraine l'appel d'une methode 
particuliere dite destructeur. II n'existe pas de ramasse-miettes en C++. 

Informations complementaires 

Avant qu'un objet soit sounds au ramasse-miettes, Java appelle la methode finalize de sa 
classe 1 . En theorie, on pourrait se fonder sur cet appel pour liberer des ressources qui ne 
le seraient pas automatiquement, comme des fichiers ouverts, des allocations de memoire, 
des elements verrouilles... En pratique, cependant, on est fortement limite par le fait 
qu'on ne maitrise pas le moment de cet appel. Dans bon nombre de cas d'ailleurs, le 
ramasse-miettes ne se declenche que lorsque la memoire commence a se faire rare... 





1. Nous verrons plus tard que toute classe dispose toujours d'une methode finalize par defaut qu'elle herite de 
la super-classe Object mais qu'il est possible d'y redefinir cette methode. 
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6 Regies d'ecriture des methodes 

Jusqu'ici, nous nous sommes contente de dire qu'une methode etait formee d'un bloc pre- 
cede d'un en-tete. Nous allons maintenant apporter quelques precisions concernant les regies 
d'ecriture d'une methode, ce qui nous permettra de distinguer les methodes fonctions des 
autres et d'aborder les arguments muets, les arguments effectifs et leurs eventuelles conver- 
sions, et enfin les variables locales. 

6.1 Methodes fonction 

Une methode peut ne fournir aucun resultat. Le mot-cle void figure alors dans son en-tete a la 
place du type de la valeur de retour. Nous avons deja rencontre des exemples de telles metho- 
des dont l'appel se presente sous la forme : 

Objet. methode (liste d' arguments) 

Mais une methode peut aussi fournir un resultat. Nous parlerons alors de methode fonction. 
Voici par exemple une methode distance qu'on pourrait ajouter a une classe Point pour obte- 
nir la distance d'un point a l'origine : 

public class Point 

{ 

double distance () 
{ double d ; 

d = Math.sqrt (x*x* + y*y) ; 
return d ; 

} 

private int x, y ; 

} 

De me me, voici deux methodes simples (deja evoquees precedemment) permettant d'obtenir 
l'abscisse et l'ordonnee d'un point : 

int getX { return x ; } 
int getY { return y ; } 

La valeur fournie par une methode fonction peut apparaitre dans une expression, comme dans 
ces exemples utilisant les methodes distance, getX et getY precedentes : 

Point a = new Point (...) ; 
double u, r ; 

u = 2 . * a . distance ( ) ; 

r = Math.sqrt ( a. getXQ * a.getXO + a.getYO * a.getYO ) ; 

On peut ne pas utiliser la valeur de retour d'une methode. Par exemple, cette instruction est 
correcte (meme si, ici, elle ne sert a rien) : 

a . distance ( ) ; 

Bien entendu, cette possibility n'aura d'interet que si la methode fait autre chose que de cal- 
culer une valeur. 
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6.2 Les arguments d'une methode 

6.2.1 Arguments muets ou effectifs 

Comme dans tous les langages, les arguments figurant dans l'en-tete de la definition d'une 
methode se nomment arguments muets (ou encore arguments ou parametres formels). lis 
jouent un role voisin de celui d'une variable locale a la methode, avec cette seule difference 
que leur valeur sera fournie a la methode au moment de son appel. Par essence, ces argu- 
ments sont de simples identificateurs ; il serait absurde de vouloir en faire des expressions. 

II est possible de declarer un argument muet avec 1'attribut^na/. Dans ce cas, le compilateur 
s'assure que sa valeur n'est pas modifiee par la methode : 

void f (final int n, double x) 
{ 

n = 12 ; // erreur de compilation 
x = 2.5 ; //OK 

} 

Les arguments fournis lors de 1' appel de la methode portent quant a eux le nom d' arguments 
effectifs (ou encore parametres effectifs). Comme on l'a deja vu a travers de nombreux exem- 
ples, en Java, il peut s'agir d'expressions (bien sur, un simple nom de variable ou une cons- 
tante constituent des cas particuliers d'expressions). On notera que cela n'est possible que 
parce que ce sont les valeurs de ces arguments qui seront effectivement transmises 1 ; nous 
reviendrons en detail sur ce point au paragraphe 9. 

6.2.2 Conversion des arguments effectifs 

Jusqu'ici, nous avions appele nos differentes methodes en utilisant des arguments effectifs 
d'un type identique a celui de l'argument muet correspondant. En fait, Java fait preuve d'une 
certaine tolerance en vous permettant d'utiliser un type different. II faut simplement que la 
conversion dans le type attendu soit une conversion implicite legale, autrement dit qu'elle 
respecte la hierarchie (ou encore, ce qui revient au meme, qu'il s'agisse d'une conversion 
autorisee par affectation). 

Voici quelques exemples usuels : 

class Point 
{ 

void deplace (int dx, int dy) { } 

} 

Point p = new Point (...) ; 
int nl, n2 ; byte b ; long q ; 



1. Dans les langages ou la transmission des arguments se fait par adresse (ou par reference), les arguments ef- 
fectifs ne peuvent pas etre des expressions. 
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p.deplace (nl, n2) ; // OK : appel normal 

p.deplace (b+3, nl) ; // OK : b+3 est deja de type int 

p.deplace (b, nl) ; // OK : b de type byte sera converti en int 

p.deplace (nl, q) ; // erreur : q de type long ne peut etre converti en int 

p.deplace (nl, (int)q) ; // OK 

Voici quelques autres exemples plus insidieux : 

class Point 
{ 

void deplace (byte dx, byte dy) { } 



Point p = new Point (...) ; 
byte bl, b2 ; 



p.deplace (bl, b2) ; // OK : appel normal 

p.deplace (bl+1, b2) ; // erreur : bl+1 de type int ne peut etre converti en byte 
p.deplace (bl++, b2) ; //OK : bl++ est de type byte 

// (mais peu conseille : on a modifie la valeur de bl) 



Informations complementaires 

En general, il n'est pas utile de savoir dans quel ordre sont evaluees les expressions figu- 
rant en arguments effectifs d'un appel de methode. Considerez cependant : 

int n=5 ; double a=2.5, b=3.5 ; 
f (n++, n, a=b, a) 

Le premier argument a pour valeur 5 (n avant incrementation). En revanche, la valeur 
du deuxieme depend de son ordre de calcul par rapport au precedent. Comme Java res- 
pecte l'ordre des arguments, on voit qu'il vaudra 6 (valeur de n a ce moment-la). Le 
troisieme argument qui correspond a la valeur de l'affectation a=b vaudra 3.5. Le der- 
nier vaudra egalement 3.5 puisqu'il s'agit de la valeur de a, apres les evaluations prece- 
dentes. En revanche, en remplacant 1' appel precedent par : 

f (n, n++, a, a=b) 

les valeurs des arguments seront respectivement 5, 5, 2.5 et 3.5. 

Notez qu'il n'est pas prudent d'ecrire des programmes fondes sur ces regies d' evalua- 
tion. D'ailleurs, dans de nombreux langages (C, C++ notamment), aucun ordre precis 
n'est prevu dans de telles situations. 

6.3 Proprietes des variables locales 

Ce paragraphe fait le point sur les variables locales, que nous avons deja utilisees de maniere 
plus ou moins intuitive. II reprend done un certain nombre d' informations qui ont deja ete 
exposees au hi de l'ouvrage. 
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Comme on s'en doute, la portee d'une variable locale (emplacement du source oil elle est 
accessible) est limitee au bloc constituant la methode oil elle est declaree. De plus, une varia- 
ble locale ne doit pas posseder le meme nom qu'un argument muet de la methode 1 : 

void f (int n) 

{ float x ; // variable locale a f 

float n ; // interdit en Java 



} 

void g () 

{ double x ; // variable locale a g, independante de x locale a f 
} 

L' emplacement d'une variable locale est alloue au moment oil Ton entre dans la fonction et il 
est libere lorsqu'on en sort. Cela signifie bien sur que cet emplacement peut varier d'un appel 
au suivant ce qui, en Java, n'a guere d'importances en pratique. Mais cela signifie surtout que 
les valeurs des variables locales ne sont pas conservees d'un appel au suivant ; on dit qu'elles 
ne sont pas remanentes 1 . 

Notez bien que les variables definies dans la methode main sont aussi des variables locales. 
Elles ont cependant cette particularite de n'etre allouees qu'une seule fois (avant le debut de 
main) et d'exister pendant toute la duree du programme (ou presque). Leur caractere non 
remanent n'a plus alors aucune incidence. 

Une variable locale est obligatoirement d'un type primitif ou d'un type classe ; dans ce der- 
nier cas, elle contient la reference a un objet. On notera qu'il n'existe pas d' objets locaux a 
proprement parler, mais seulement des references locales a des objets dont l'emplacement 
memoire est alloue explicitement par un appel a new. 

Comme nous l'avons deja mentionne, les variables locales ne sont pas initialisees de facon 
implicite (contrairement aux champs des objets). Toute variable locale, y compris une refe- 
rence a un objet, doit etre initialisee avant d'etre utilisee, faute de quoi on obtient une erreur 
de compilation. 

Remarque 

Les variables locales a une methode sont en fait des variables locales au bloc constituant 
la methode. En effet, on peut aussi definir des variables locales a un bloc. Dans ce cas, 
leur portee est tout naturellement limitee a ce bloc ; leur emplacement est alloue a l'entree 
dans le bloc et il disparait a la sortie. II n'est pas permis qu'une variable locale porte le 
meme nom qu'une variable locale d'un bloc englobant. 



1. Dans certains langages, cette possibility est autorisee, mais alors la variable locale masque 1' argument muet 
de meme nom. De toute fagon, il s'agit d'une situation deconseillee. 

2. D'ailleurs, sans cette propriete, le compilateur ne pourrait pas s'assurer de la bonne initialisation des variables 
locales. 
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void f () 

{ int n ; // n est accessible de tout le bloc constituant f 



for (...) 

{ int p ; // p if est connue que dans le bloc de for 

int n ; // interdit : n existe deja dans un bloc englobant 



{ int p ; // p n' est connue que dans ce bloc ; elle est allouee ici 

// et n' a aucun rapport avec la variable p ci-dessus 

} // et elle sera desallouee ici 

} 

Notez qu'on peut creer artificiellement un bloc, independamment d'une quelconque 
instruction structuree comme if, for. C'est le cas du deuxieme bloc interne a notre fonc- 
tion/ci-dessus. 



7 Champs et methodes de classe 

En Java, on peut definir des champs qui, au lieu d'exister dans chacune des instances de la 
classe, n'existent qu'en un seul exemplaire pour toutes les instances d'une meme classe. II 
s'agit en quelque sorte de donnees globales partagees par toutes les instances d'une meme 
classe. On parle alors de champs de classe ou de champs statiques. De meme, on peut definir 
des methodes de classe (ou statiques) qui peuvent etre appelees independamment de tout 
objet de la classe (c'est le cas de la methode main). 

7.1 Champs de classe 

7.1.1 Presentation 

Considerons la definition (simpliste) de classe suivante (nous ne nous preoccuperons pas des 
droits d'acces aux champs neXy) : 

class A 
{ int n ; 
float y ; 

} 

Chaque objet de type A possede ses propres champs n et x. Par exemple, avec cette 
declaration : 

A al = new A() , a2 = new A() ; 
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on aboutit a une situation qu'on peut schematise! - ainsi : 



al.n 

al.y 



Objet al 



a2.n 
a2.y 



Objet a2 



Mais Java permet de definir ce qu'on nomme des champs de classe (ou statiques) qui n' exis- 
tent qu'en un seul exemplaire, quel que soit le nombre d'objets de la classe. II suffit pour cela 
de les declarer avec l'attribut static. Par exemple, si nous definissons : 

class B 

{ static int n ; 
float y ; 

} 



B al = new B(), a2 = new B() ; 



nous aboutissons a cette situation : 



al.n ou B.n 
al.y 



_ a2.n ou B.n 
a2.y 



Objet al 



Objet a2 



Les notations al.n et a2.n designent done le meme champ. En fait, ce champ existe indepen- 
damment de tout objet de sa classe. II est possible (et meme preferable) de s'y referer en le 
nommant simplement : 

B.n // champ (statique) n de la classe B 

Bien entendu, ces trois notations (al.n, al.n, B.n) ne seront utilisables que pour un champ 
non prive. II sera possible de prevoir des champs statiques prives, mais Faeces ne pourra 
alors se faire que par le biais de methodes (nous verrons plus loin qu'il pourra s'agir de 
methodes de classe). 

Notez que depuis une methode de la classe B, on accedera a ce champ on le nommant 
comme d'habitude n (le prefixe B. n'est pas necessaire, mais il reste utilisable). 



7.1.2 Exemple 

Voici un exemple complet de programme utilisant une classe nommee Obj comportant un 
champ statique prive rib, destine a contenir, a tout instant, le nombre d'objets de type Obj 
deja crees. Sa valeur est incrementee de 1 a chaque appel du constructeur. Nous nous conten- 
tons d'afficher sa valeur a chaque creation d'un nouvel objet. 
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class Obj 

{ public Obj () 

{ System . out . print ("++ creation objet Obj ; ") ; 
nb ++ ; 

System. out. println ("il y en a maintenant " + nb) 

} 

private static long nb=0 ; 

} 

public class TstObj 

{ public static void main (String args[ ] ) 
{ Obj a ; 

System. out. println ("Main 1") ; 
a = new Obj () ; 

System. out. println ("Main 2") ; 
Obj b ; 

System. out. println ("Main 3") ; 

b = new Obj () ; 

Obj c = new Obj () ; 

System. out. println ("Main 4") ; 



Main 1 

++ creation objet Obj ; il y en a maintenant 1 
Main 2 
Main 3 

++ creation objet Obj ; il y en a maintenant 2 
++ creation objet Obj ; il y en a maintenant 3 
Main 4 



Exemple d' utilisation d'un champ de classe 



Remarque 

La classe Obj ne tient pas compte des objets eventuellement detruits lors de l'execution. 
En fait, on ne peut pas connaitre le moment oil un objet devient candidat au ramasse-miet- 
tes. En revanche, si son emplacement est recupere, on sait qu'il y aura appel de la 
methode^naZ/ze. En decrementant le compteur d' objets de 1 dans cette methode, on voit 
qu'on peut connaitre plus precisement le nombre d' objets existant encore (y compris 
cependant ceux qui ne sont plus references mais pas encore detruits). 
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7.2 Methodes de classe 
7.2.1 Generalites 

Nous venons de voir comment definir des champs de classe, lesquels n' existent qu'en un seul 
exemplaire, independamment de tout objet de la classe. De maniere analogue, on peut imagi- 
ner que certaines methodes d'une classe aient un role independant d'un quelconque objet. Ce 
serait notamment le cas d'une methode se contentant d'agir sur des champs de classe ou de 
les utiliser. 

Bien sur, vous pouvez toujours appeler une telle methode en la faisant porter artificiellement 
sur un objet de la classe (alors que la reference a un tel objet n'est pas utile). La encore, Java 
vous permet de definir une methode de classe en la declarant avec le mot-cle static. L'appel 
d'une telle methode ne necessite plus que le nom de la classe correspondante. 

Bien entendu, une methode de classe ne pourra en aucun cas agir sur des champs usuels (non 
statiques) puisque, par nature, elle n'est liee a aucun objet en particulier. Voyez cet exemple : 

class A 
{ 

private float x ; // champ usuel 

private static int n ; // champ de classe 



public static void f () // methode de classe 

{ // ici, on ne peut pas acceder a x, champ usuel, 

// mais on peut acceder au champ de classe n 

} 

) 



A a ; 

A.f () ; // appelle la methode de classe f de la classe A 
a.f() ; // reste autorise, mais deconseille 

7.2.2 Exemple 

Voici un exemple illustrant l'emploi d'une methode de classe. II s'agit de l'exemple prece- 
dent (paragraphe 7.1.2), dans lequel nous avons introduit une methode de classe nommee 
nbObj affichant simplement le nombre d'objets de sa classe. 

class Obj 

{ public Obj () 

{ System. out. print ("++ creation objet Obj ; ") ; 
nb ++ ; 

System. out .println ("il y en a maintenant " + nb) ; 

} 

public static long nbObj () 

{ return nb ; 

} 

private static long nb=0 ; 

) 
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public class Tst0bj2 

{ public static void main (String args! ] ) 
{ Obj a ; 

System . out . pr intln ( "Main 1 : nb obj ets = " + Obj . nbOb j ( ) ) ; 
a = new Obj () ; 

System . out . pr intln ( "Main 2 : nb obj ets = " + Obj . nbOb j ( ) ) ; 
Obj b ; 

System, out. println ("Main 3 : nb obj ets = " + Obj.nbObjO ) ; 
b = new Obj () ; 
Obj c = new Obj () ; 

System . out .println ( "Main 4 : nb obj ets = " + Obj . nbOb j ( ) ) ; 



Main 1 : nb obj ets = 0 
++ creation objet Obj ; 
Main 2 : nb obj ets = 1 
Main 3 : nb obj ets = 1 
++ creation objet Obj ; 
++ creation objet Obj ; 
Main 4 : nb obj ets = 3 



il y en a maintenant 1 



il y en a maintenant 2 
il y en a maintenant 3 



Exemple d' utilisation d'une methode de classe 

7.2.3 Autres utilisations des methodes de classe 

En Java, les methodes de classe s'averent pratiques pour permettre a differents objets d'une 
classe de disposer d' informations collectives. Nous en avons vu un exemple ci-dessus avec le 
comptage d'objets d'une classe. On pourrait aussi introduire dans une des classes Point deja 
rencontrees deux champs de classe destines a contenir les coordonnees d'une origine parta- 
gee par tous les points. 

Mais les methodes de classe peuvent egalement fournir des services n' ay ant de signification 
que pour la classe meme. Ce serait par exemple le cas d'une methode fournissant l'identifica- 
tion d'une classe (nom de classe, numero d' identification, nom de l'auteur...). 

Enfin, on peut utiliser des methodes de classe pour regrouper au sein d'une classe des fonc- 
tionnalites ayant un point commun et n'etant pas liees a un quelconque objet. C'est le cas de 
la classe Math qui contient des fonctions de classe telles que sqrt, sin, cos. Ces methodes 
n'ont d'ailleurs qu'un tres lointain rapport avec la notion de classe. En fait, ce regroupement 
est le seul moyen dont on dispose en Java pour retrouver (artificiellement) la notion de fonc- 
tion independante qu'on trouve dans les langages usuels (objet ou non). Notez que c'est cette 
demarche que nous avons employee pour realiser la classe Clavier qui procure des methodes 
(statiques) de lecture au clavier. 
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7.3 Initialisation des champs de classe 

7.3.1 Generalites 

Nous avons vu comment les champs usuels se trouvent initialises : d'abord a une valeur par 
defaut, ensuite a une valeur fournie (eventuellement) lors de leur declaration, enfin par le 
constructeur. 

Ces possibilites vont s'appliquer aux champs statiques avec cependant une exception concer- 
nant le constructeur. En effet, alors que F initialisation d'un champ usuel est faite a la creation 
d'un objet de la classe, celle d'un objet statique doit etre faite avant la premiere utilisation de 
la classe. Cet instant peut bien sur coincider avec la creation d'un objet, mais il peut aussi la 
preceder (il peut meme n'y avoir aucune creation d'objets). C'est pourquoi F initialisation 
d'un champ statique se limite a : 

• F initialisation par defaut, 

• F initialisation explicite eventuelle. 
Considerez cette classe : 

class A 

{ 

public static void f () ; 

private static int n = 10 ; 
private static int p ; 

} 

Une simple declaration telle que la suivante entrainera F initialisation des champs statiques de 
A: 

A a ; // aucun objet de type A n' est encore cree, les champs statiques 

// de A sont intialises : p (implicitement) a 0, n (explicitement) a 10 

II en ira de meme en cas d'appel d'une methode statique de cette classe, meme si aucun objet 
n'a encore ete cree : 

A.f () ; // initialisation des statiques de A, si pas deja fait 
Notez cependant qu'un constructeur, comme d'ailleurs toute methode, peut tres bien modifier 
la valeur d'un champ statique ; mais il ne s'agit plus d'une initialisation, c'est-a-dire d'une 
operation accompagnant la creation du champ. 

Enfin, un champ de classe peut etre declare final. II doit alors obligatoirement recevoir une 
valeur initiale, au moment de sa declaration. En effet, comme tout champ declare final, il ne 
peut pas etre initialise implicitement. De plus, comme il s'agit d'un champ de classe, il ne 
peut plus etre initialise par un constructeur. 

7.3.2 Bloc d'initialisation statique 

Java permet d'introduire dans la definition d'une classe un ou plusieurs blocs d' instructions 
precedes du mot static. Dans ce cas, leurs instructions n'ont acces qu'aux champs statiques 
de la classe. 
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Contrairement aux blocs d' initialisation ordinaires (sans static) que nous avions deconseille, 
les blocs d'initialisation statiques presentent un interet lorsque 1' initialisation des champs sta- 
tiques ne peut etre faite par une simple expression. En effet, il n'est plus possible de se repo- 
ser sur le constructeur, non concerne par l'initialisation des champs statiques. En voici un 
exemple qui fait appel a la notion de tableau que nous etudierons plus loin 1 : 
class A 

{ private static int t[ ] ; 

static { 

int nEl = Clavier . lirelnt () ; 
t = new int[ nEl] ; 

for (int i=0 ; i<nEl ; i++) t[ i] = i ; 

} 



} 

8 Surdefinition de methodes 

On parle de surdefinition 2 (ou encore de surcharge) lorsqu'un meme symbole possede plu- 
sieurs significations differentes entre lesquelles on choisit en fonction du contexte. Sans 
meme en avoir conscience, nous sommes en presence d'un tel mecanisme dans des expres- 
sions arithmetiques telles que a+b : la signification du symbole + depend du type des varia- 
bles a et b. 

En Java, cette possibilite de surdefinition s'applique aux methodes d'une classe, y compris 
aux methodes statiques. Plusieurs methodes peuvent porter le meme nom, pour peu que le 
nombre et le type de leurs arguments permettent au compilateur d'effectuer son choix. 

8.1 Exemple introductif 

Considerons cet exemple, dans lequel nous avons dote la classe Point de trois methodes 
deplace : 

• la premiere a deux arguments de type int, 

• la deuxieme a un seul argument de type int, 

• la troisieme a un seul argument de type short. 

class Point 

{ public Point (int abs, int ord) // constructeur 
{ x = abs ; y = ord ; 
} 



1 . Attention, la declaration de t doit preceder son utilisation. Elle doit done ici etre placee avant le bloc d'initia- 
lisation statique. 

2. En anglais overload. 
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public void deplace (int dx, int dy) // deplace (int, int) 
{ x += dx ; y += dy ; 



public void deplace (int dx) 
{ x += dx ; 



// deplace (int) 



public void deplace (short dx) 



// deplace (short) 



{ x += dx ; 
private int x, y ; 

} 

public class Surdefl 

{ public static void main (String args[ ] ) 
{ Point a = new Point (1, 2) ; 

a. deplace (1, 3) ; // appelle deplace (int, int) 
a. deplace (2) ; // appelle deplace (int) 
short p = 3 ; 

a. deplace (p) ; // appelle deplace (short) 
byte b = 2 ; 

a. deplace (b) ; // appelle deplace (short) apres conversion de b en short 



Les commentaires en regard des differents appels indiquent quelle est la methode effective - 
ment appelee. Les choses sont relativement evidentes ici. Notons simplement la conversion 
de byte en short dans le dernier appel. 



Supposons que notre classe Point precedente ait ete dotee (a la place des precedentes) des 
deux methodes deplace suivantes : 

public void deplace (int dx, byte dy) // deplace (int, byte) 
{ x += dx ; y += dy ; 

} 

public void deplace (byte dx, int dy) // deplace (byte, int) 
{ x += dx ; 

} 

Considerons alors ces instructions : 

Point a = . . . 
int n ; byte b ; 

a. deplace (n, b) ; // OK : appel de deplace (int, byte) 
a. deplace (b, n) ; // OK : appel de deplace (byte, int) 
a. deplace (b, b) ; // erreur : ambiguite 

Le dernier appel sera refuse par le compilateur. Meme sans connaitre les regies effectivement 
utilisees dans ce cas, on voit bien qu'il existe deux possibilites apparemment equivalentes : 



Exemple de surdefinition de la methode deplace de la classe Point 



8.2 En cas d'ambigui'te 
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soit convertir le premier argument en int et utiliser deplace ( int, byte), soit convertir le second 
argument en int et utiliser deplace (byte, int). 

En revanche, la presence de conversions implicites dans les evaluations d'expressions arith- 
metiques peut ici encore avoir des consequences inattendues : 

a. deplace (2*b, b) ; // OK : 2*b de type int — > appel de deplace (int, byte) 

8.3 Regies generales 

A la rencontre d'un appel donne, le compilateur recherche toutes les methodes acceptables et 
il choisit la meilleure si elle existe. Pour qu'une methode soit acceptable, il faut : 

• qu'elle dispose du nombre d' arguments voulus, 

• que le type de chaque argument effectif soit compatible par affectation avec le type de 1' ar- 
gument muet correspondant 1 , 

• qu'elle soit accessible (par exemple, une methode privee sera acceptable pour un appel de- 
puis l'interieur de la classe, alors qu'elle ne le sera pas pour un appel depuis l'exterieur). 

Le choix de la methode se deroule alors ainsi : 

• Si aucune methode n'est acceptable, il y a erreur de compilation. 

• Si une seule methode est acceptable, elle est bien sur utilisee pour 1' appel. 

• Si plusieurs methodes sont acceptables, le compilateur essaie d'en trouver une qui soit 
meilleure que toutes les autres. Pour ce faire, il procede par eliminations successives. Plus 
precisement, pour chaque paire de methodes M et M', il regarde si tous les arguments 
(muets, cette fois) de M sont compatibles par affectation avec tous les arguments muets de 
M' ; si tel est le cas, M' est eliminee (elle est manifestement moins bonne que M). 

Apres elimination de toutes les methodes possibles : 

- s'il ne reste plus qu'une seule methode, elle est utilisee, 

- s'il n' en reste aucune, on obtient une erreur de compilation, 

- s'il en reste plusieurs, on obtient une erreur de compilation mentionnant une ambiguite. 

Remarques 

1 Le type de la valeur de retour d'une methode n'intervient pas dans le choix d'une 
methode surdefinie 2 . 

1 . Notez que Ton retrouve les regies habituelles de l'appel d'une methode non surdefinie (qui correspond au cas 
ou une seule est acceptable). 

2. On notera que si le type d'un argument effectif est parfaitement defini par l'appel d'une methode, il n'en va 
plus de meme pour la valeur de retour. Au contraire, c'est meme la methode choisie qui definira ce type. 
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2 On peut surdefinir des methodes de classe, de la meme maniere qu'on surdefinit des 
methodes usuelles. 

3 Les arguments declares final n'ont aucune incidence dans le processus de choix. Ainsi, 
avec : 

public void deplace (int dx) { } 

public void deplace (final int dx) { } 

vous obtiendrez une erreur de compilation (independamment de tout appel de deplace), 
comme si vous aviez defini deux foix la meme methode 1 . Bien entendu, ces deux defini- 
tions seront acceptees (comme elles le seraient sans final) : 

public void deplace (int dx) { } 

public void deplace (final byte dx) { } 

4 Les regies de recherche d'une methode surdefinie devront etre completees par : 

- les possibilites de conversion d'un objet en objet d'une classe de base (etudiees au cha- 
pitre 8). 

- les possibilites introduites par le JDK 5.0 : conversions entre types primitifs et types 
enveloppes (etudiees dans le chapitre relatif a 1' heritage) ; utilisation eventuelle d' ar- 
guments variables en nombre (etudiee dans le chapitre relatif aux tableaux). 



EnC++ 

C++ dispose aussi de la surdefinition des methodes (et des fonctions ordinaires). Les 
regies de determination de la bonne methode sont toutefois beaucoup plus complexes 
qu'en Java (Fintuition ne suffit plus toujours !). Contrairement a Java, C++ permet de 
fixer des valeurs d' arguments par defaut, ce qui peut eviter certaines surdefinitions. 



8.4 Surdefinition de constructeurs 

Les constructeurs peuvent etre surdefinis comme n'importe quelle autre methode. Voici un 
exemple dans lequel nous dotons une classe Point de constructeurs a 0, 1 ou 2 arguments : 



class Point 
{ 

public Point () // constructeur 1 (sans argument) 

{ x = 0 ; y = 0 ; 

} 



1 . Cette regie est liee au mode de transmission des arguments (par valeur). Nous verrons que, dans les deux cas, 
deplace recoit une copie de 1' argument effectif, de sorte que la presence de final n'a aucune incidence sur le 
fonctionnement de la methode. 
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public Point (int abs) // constructeur 2 (un argument) 

{ x = y = abs ; 

} 

public Point (int abs, int ord ) // constructeur 3 (deux arguments) 

{ x = abs ; y = ord ; 

} 

public void affiche () 

{ System. out. println ("Coordonnees : " + x + " " + y) ; 
} 

private int x, y ; 

} 

public class Surdef2 

{ public static void main (String argst ] ) 

{ Point a = new Point () ; // appelle constructeur 1 

a. afficheO ; 

Point b = new Point (5) ; // appelle constructeur 2 

b. afficheO ; 

Point c = new Point (3, 9) ; // appelle constructeur 3 

c. afficheO ; 

} 

} 

Coordonnees : 0 0 
Coordonnees : 5 5 
Coordonnees : 3 9 

Exemple de surdefinition d'un constructeur 

Remarque 

Nous verrons plus loin qu'une methode peut posseder des arguments de type classe. II est 
possible de (sur)definir un constructeur de la classe Point, de facon qu'il construise un 
point dont les coordonnees seront identiques a celle d'un autre point fourni en argument. 
II suffit de proceder ainsi : 

public Point (Point a) // constructeur par copie d un autre point 

{ x = a.x ; y = a.y ; 
} 



Point a = new Point (1, 3) ; // construction usuelle 

Point d = new Point (d) ; // appel du constructeur par copie d' un point 

Notez qu'ici la distinction entre copie superficielle et copie profonde n'existe pas {Point ne 
contient aucun champ de type classe). On peut dire que ce constructeur realise le clonage 
d'un point. 
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8.5 Surdefinition et droits d'acces 



Nous avons vu qu'une methode pouvait etre publique ou privee. Dans tous les cas, elle peut 
etre surdefinie. Cependant, les methodes privees ne sont pas accessibles en dehors de la 
classe. Dans ces conditions, suivant son emplacement, un meme appel peut conduire a 
l'appel d'une methode differente. 

public class Surdfacc 

{ public static void main (String args[ ] ) 
{ A a = new A() ; 

a.g() ; 

System. out .println (" dans main") ; 

int n=2 ; float x=2 . 5f ; 
a.f(n) ; a.f(x) ; 

} 

} 

class A 

{ public void f (float x) 

{ System. out. println ("f (float) x = " + x ) ; 

} 

private void f (int n) 

{ System. out. println ("f (int) n = " + n) ; 
} 

public void g() 

{ int n=l ; float x=1.5f ; 

System. out. println (" dans g ") ; 

f(n) ; f(x) ; 

} 

} 

dans g 

f (int) n = 1 

f (float) x = 1.5 

dans main 

f (float) x = 2.0 
f (float) x = 2.5 



Dans main, l'appel a.fln) provoque l'appel de la m6thode /(float) de la classe A, car c'est la 
seule qui soit acceptable (flint) etant privee). En revanche, pour l'appel comparable f(n) 
effectue au sein de la methode g de la classe A, les deux methodes / sont acceptables ; c'est 
done flint) qui est utilisee. 
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9 Echange d'informations avec les methodes 

En Java, la transmission d'un argument a une methode et celle de son resultat ont toujours 
lieu par valeur. Comme pour F affectation, les consequences en seront totalement differentes, 
selon que Ton a affaire a une valeur d'un type primitif ou d'un type classe. 

9.1 Java transmet toujours les informations par valeur 

Dans les differents langages de programmation, on rencontre principalement deux facons 
d'effectuer le transfert d' information requis par la correspondance entre argument effectif et 
argument muet : 

• par valeur : la methode recoit une copie de la valeur de 1' argument effectif ; elle travaille 
sur cette copie qu'elle peut modifier a sa guise, sans que cela n'ait d' incidence sur la valeur 
de 1' argument effectif ; 

• par adresse (ou par reference) : la methode recoit l'adresse (ou la reference) de 1' argument 
effectif avec lequel elle travaille alors directement ; elle peut done, le cas echeant, en modi- 
fier la valeur. 

Certains langages permettent de choisir entre ces deux modes de transfert. Java emploie sys- 
tematiquement le premier mode. Mais lorsqu'on manipule une variable de type objet, son 
nom represente en fait sa reference de sorte que la methode recoit bien une copie ; mais il 
s'agit d'une copie de la reference. La methode peut done modifier l'objet concerne qui, quant 
a lui, n'a pas ete recopie. En definitive, tout se passe comme si on avait affaire a une transmis- 
sion par valeur pour les types primitifs et a une transmission par reference pour les objets. 

Les memes remarques s'appliquent a la valeur de retour d'une methode. 

9.2 Consequences pour les types primitifs 

Ainsi, une methode ne peut pas modifier la valeur d'un argument effectif d'un type primitif. 
Cela est rarement genant dans un contexte de programmation orientee objet. 

Voici cependant un exemple, un peu artificiel, montrant les limites de ce mode de transmis- 
sion. Supposons qu'on souhaite realiser une methode nommee Echange permettant d'echan- 
ger les valeurs de deux variables de type entier recues en argument. Comme une telle 
methode ne concerne aucun objet, on en fera tout naturellement une methode de classe 1 
d'une classe quelconque, par exemple Util (contenant par exemple differentes methodes utili- 
taires). Nous pourrions par exemple proceder ainsi (la methode main sert ici a tester notre 
methode Echange et a prouver qu'elle ne fonctionne pas) : 



1 . Dans certains langages tels que C++, on utiliserait tout simplement une fonction usuelle. Mais Java oblige a 
faire de toute fonction une methode, quitte a ce qu'il s'agisse artificiellement d'une methode de classe. 
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class Util 

{ public static void Echange (int a, int b) // ne pas oublier static 
{ System. out. println ("debut Echange : " + a + " " + b) ; 
int c ; 

c = a ; a = b ; b = c ; 

System. out. println ("fin Echange : " + a + " " + b) ; 

} 

} 

public class Echange 

{ public static void main (String args[ ] ) 
{ int n = 10, p = 20 ; 

System. out .println ("avant appel : " + n + " " + p) ; 
Util. Echange (n, p) ; 

System. out. println ("apres appel : " + n + " " + p) ; 

} 

) 



avant appel : 10 20 

debut Echange : 10 20 

fin Echange : 20 10 

apres appel : 10 20 



Quand la transmission par valeur s'avere genante 

Comme on peut s'y attendre, un echange a bien eu lieu ; mais il a porte sur les valeurs des 
arguments muets a et b de la methode Echange. Les valeurs des arguments effectifs n et p de 
la methode main n'ont nullement ete affectes par l'appel de la methode Echange. 

J3Jfr En C++ 

En C++ on peut traiter le probleme precedent en transmettant a une fonction non plus les 
valeurs de variables, mais leurs adresses, par le biais de pointeurs. Cela n'est pas possible 
en Java, qui ne dispose pas de pointeurs : c'est d'ailleurs ce qui contribue largement a sa 
securite. 

9.3 Cas des objets transmis en argument 

Jusqu'ici, les methodes que nous avons rencontrees ne possedaient que des arguments d'un 
type primitif. Bien entendu, Java permet d'utiliser des arguments d'un type classe. C'est ce 
que nous allons examiner ici. 

9.3.1 L unite d'encapsulation est la classe 

Supposez que nous voulions, au sein d'une classe Point, introduire une methode nommee 
coincide chargee de detecter la coincidence eventuelle de deux points. Son appel (par exem- 
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pie au sein d'une methode main) se presentera obligatoirement sous la forme suivante, a etant 
un objet de type Point : 
a . coincide (...) 

II nous faudra done transmettre le second point en argument ; s'il se nomme b, cela nous con- 
duira a un appel de cette forme : 

a. coincide (b) 

ou encore, compte tenu de la symetrie du probleme : 

b. coincide (a) 

Voyons comment ecrire la methode coincide. Son en-tete pourrait se presenter ainsi : 

public boolean coincide (Point pt) 
II nous faut comparer les coordonnees de Fobjet fourni implicitement lors de l'appel (ses 
membres etant designes comme d' habitude par x et y) avec celles de Fobjet pt recu en argu- 
ment et dont les champs sont alors designes par pt.x et pt.y. La methode coincide se presen- 
tera ainsi : 

public boolean coincide (Point pt) 

{ return ((pt.x == x) && (pt.y == y) ) ; 
} 

On voit que la methode coincide, appelee pour un objet a, est autorisee a acceder aux champs 
prives d'un autre objet b de la meme classe. On traduit cela en disant qu'en Java, l'unite 
d'encapsulation est la classe et non l'objet. Notez que nous avions deja eu l'occasion de 
signaler que seules les methodes d'une classe pouvaient acceder aux champs prives de cette 
classe. Nous voyons clairement ici que cette autorisation concerne bien tous les objets de la 
classe, et non seulement l'objet courant. 

Voici un exemple complet de programme, dans lequel la classe a ete reduite au strict 
minimum : 

class Point 

{ public Point (int abs, int ord) 
{ x = abs ; y = ord ; } 
public boolean coincide (Point pt) 
{ return ((pt.x == x) && (pt.y == y) ) ; 
} 

private int x, y ; 

} 

public class Coincide 

{ public static void main (String args[ ] ) 
{ Point a = new Point (1, 3) ; 
Point b = new Point (2, 5) ; 
Point c = new Point (1,3) ; 

System. out. println ("a et b : " + a. coincide (b) + " " + b. coincide (a) ) ; 
System. out. println ("a et c : " + a. coincide (c) + " " + c. coincide (a) ) ; 

} 

) 
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a et b : false false 
a et c : true true 

Test de coincidence de deux points par une methode 



Remarques 

1 Bien entendu, lorsqu'une methode d'une classe rrecoit en argument un objet de classe 
T', differente de T, elle n'a pas acces aux champs ou methodes privees de cet objet. 

2 En theorie, le test de coincidence de deux points est "symetrique" puisque l'ordre dans 
lequel on considere les deux points est indifferent. Cette symetrie ne se retrouve pas 
dans la definition de coincide, pas plus que dans son appel. Cela provient du mecanisme 
meme d' appel de methode. On pourrait eventuellement faire effectuer ce test de coinci- 
dence par une methode de classe, ce qui retablirait la symetrie, par exemple : 

class Point 

{ public Point (int abs, int ord) 
{ x = abs ; y = ord ; 

} 

public static boolean coincide (Point pi, Point p2) 
{ return ((pl.x == p2.x) && (pl.y == p2.y)) ; 

} 

private int x, y ; 

} 

public class Coincid2 

{ public static void main (String args[ ] ) 
{ Point a = new Point (1, 3) ; 
Point b = new Point (2, 5) ; 
Point c = new Point (1,3) ; 

System. out. println ("a et b : " + Point. coincide (a, b) ) ; 
System. out. println ("a et c : " + Point. coincide (a, c) ) ; 

} 

} 

a et b : false 
a et c : true 

Test de coincidence de deux points par une methode statique 

9.3.2 Consequences de la transmission de la reference d'un objet 

Comme nous l'avons deja dit, lors d'un appel de methode, les arguments sont transmis par 
recopie de leur valeur. Nous en avons vu les consequences pour les types primitifs. Dans le 
cas d'un argument de type objet, en revanche, la methode recoit la copie de la reference a 
l'objet. Elle peut done tout a fait modifier l'objet correspondant. Cet aspect n'apparaissait pas 




9 - Echange d'informations avec les methodes 



145 



dans nos precedents exemples puisque la methode coincide n'avait pas a modifier les coor- 
donnees des points recus en argument. 

Nous vous proposons maintenant un exemple dans lequel une telle modification est neces- 
saire. Nous allons introduire dans une classe Point une methode nommee permute, chargee 
d'echanger les coordonnees de deux points. Elle pourrait se presenter ainsi : 

public void permute (Point a) 

{ Point c = new Point (0,0) ; 

c.x = a.x ; c.y = a.y ; // copie de a dans c 

a.x=x; a.y=y; // copie du point courant dans a 

x=c.x; y=c.y; // copie de c dans le point courant 

} 

Cette methode recoit en argument la reference a d'un point dont elle doit echanger les coor- 
donnees avec celles du point concerne par la methode. Ici, nous avons cree un objet local c de 
classe Point qui nous sert a effectuer 1' echange 1 . Illustrons le deroulement de notre methode. 
Supposons que Ton ait cree deux points de cette facon : 

Point a = new Point (1, 2) ; 
Point b = new Point (5, 6) ; 

ce qu'on peut illustrer ainsi : 




1 . Nous aurions egalement pu utiliser deux variables locales de type int. 
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A la fin de 1' execution de la methode (avant son retour), la situation se presente ainsi : 



a 



b 




Notez bien que ce ne sont pas les references contenues dans a et b qui ont change, mais seu- 
lement les valeurs des objets correspondants. L'objet reference par c deviendra candidat au 
ramasse-miettes des la sortie de la methode permute. 

Voici un programme complet utilisant cette methode permute : 

class Point 
{ 

public Point (int abs, int ord) 
{ x = abs ; y = ord ; 

} 

public void permute (Point a) // methode c? Echange les coordonnees 

// du point courant avec celles de a 

{ Point c = new Point (0,0) ; 

c.x=a.x;c.y=a.y; // copie de a dans c 

a.x=x; a.y=y; // copie du point courant dans a 

x=c.x; y=c.y; // copie de c dans le point courant 

} 

public void affiche () 

{ System. out .println ("Coordonnees : " + x + " " + y) ; 

} 

private int x, y ; 

} 

public class Permute 

{ public static void main (String args[ ] ) 
{ Point a = new Point (1, 2) ; 
Point b = new Point (5, 6) ; 
a.afficheO ; b. affiche () ; 
a. permute (b) ; 
a . affiche ( ) ; b . affiche ( ) ; 

} 

) 
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Coordonnees : 1 2 

Coordonnees : 5 6 

Coordonnees : 5 6 

Coordonnees : 1 2 

Methode de permutation des coordonnees de deux points 

9.4 Cas de la valeur de retour 

Comme on peut s'y attendre, on recoit toujours la copie de la valeur fournie par une methode. 
La encore, cela ne pose aucun probleme lorsque cette valeur est d'un type primitif. Mais une 
methode peut aussi renvoyer un objet. Dans ce cas, elle fournit une copie de la reference a 
l'objet concerne. Voici un exemple exploitant cette remarque ou nous dotons une classe Point 
d'une methode fournissant le symetrique du point conceme. 

class Point 
{ 

public Point (int abs, int ord) 

{ x = abs ; y = ord ; 

} 

public Point symetrique ( ) 
{ Point res ; 

res = new Point (y, x) ; 

return res ; 

} 

public void affiche () 

{ System. out. println ("Coordonnees : " + x + " " + y) ; 
} 

private int x, y ; 

} 

public class Sym 

{ public static void main (String args[ ] ) 
{ Point a = new Point (1, 2) ; 

a. afficheO ; 

Point b = a . symetrique ( ) ; 

b. afficheO ; 

} 

} 

Coordonnees : 1 2 
Coordonnees : 2 1 

Exemple de methode fournissant en retour le symetrique d'un point 



Notez bien que la variable locale res disparait a la fin de 1' execution de la methode symetri- 
que. En revanche, l'objet cree par new Pointfy, x) continue d'exister. Comme sa reference est 
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effectivement copiee par main dans b, il ne sera pas candidat au ramasse-miettes. Bien 
entendu, on pourrait envisager la situation suivante : 

Point p = new Point (2, 5) ; 



for (...) 

{ Point s = p . symetrique ( ) ; 
} 

Si la reference contenue dans s n'est pas recopiee dans une autre variable au sein de la boucle 
for, Fobjet reference par s (cree par la methode symetrique) deviendra candidat au ramasse- 
miettes a la fin de la boucle/or. 



9.5 Autoreference : le mot-cle this 

9.5.1 Generalites 

Considerons F application d'une methode a un objet, par exemple : 

a.deplace (4, 5) ; 

II est evident que cette methode deplace recoit, au bout du compte, une information lui per- 
mettant d'identifier Fobjet concerne (ici a), afin de pouvoir agir convenablement sur lui. 

Bien entendu, la transmission de cette information est prise en charge automatiquement par 
le compilateur. C'est ce qui permet, dans la methode {deplace), d'acceder aux champs de 
Fobjet sans avoir besoin de preciser sur quel objet on agit. 

Mais il peut arriver qu'au sein d'une methode, on ait besoin de faire reference a Fobjet dans 
sa globalite (et non plus a chacun de ses champs). Ce sera par exemple le cas si Fon souhaite 
transmettre cet objet en argument d'une autre methode. Un tel besoin pourrait apparaitre dans 
une methode destinee a ajouter Fobjet concerne a une liste chainee... 

Pour ce faire, Java dispose du mot-cle this : 

class A 
{ 

public void f(...) // methode de la classe A 

{ // ici this designe la reference a 1' objet ayant appele la methode f 

} 

} 

9.5.2 Exemples d'utilisation de this 

A titre d'illustration du role de this, voici une facon artificielle d'ecrire la methode coincide 
rencontree au paragraphe 9.3.1 : 

public boolean coincide (Point pt) 

{ return ((pt.x == this.x) && (pt.y == this.y)) ; 

} 

Notez que F aspect symetrique du probleme apparait plus clairement. 
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Ce type de notation artificielle peut s'averer pratique dans l'ecriture de certains construe teurs. 
Par exemple, le constructeur suivant : 

public Point (int abs, int ord) 
{ x = abs ; 
y = ord ; 

} 

peut aussi etre ecrit ainsi : 

public Point (int x, int y) // notez les noms des arguments muets ici 
{ this.x = x ; // ici x designe le premier argument de Point 

// le champ x de 1' objet courant est masque ; mais 
//on peut le nommer this.x 

this.y = x ; 

} 

Cette demarche permet d' employer des noms d' arguments identiques a des noms de champ, 
ce qui evite parfois d' avoir a creer de nouveaux identificateurs, comme abs et ord ici. 

9.5.3 Appel d'un constructeur au sein d'un autre constructeur 

Nous avons deja vu qu'il n'etait pas possible d'appeler directement un constructeur, comme 
dans : 

a. Point (2, 3) ; 

II existe cependant une exception : au sein d'un constructeur, il est possible d'en appeler un 
autre de la meme classe (et portant alors sur Fobjet courant). Pour cela, on fait appel au mot- 
cle this qu'on utilise cette fois comme un nom de methode. 

Voici un exemple simple d'une classe Point dotee d'un constructeur sans argument qui se 
contente d'appeler un constructeur a deux arguments avec des coordonnees nulles : 

class Point 

{ public Point (int abs, int ord) 
{ x = abs ; 
y = ord ; 

System. out. println ("constructeur deux arguments : " + x + " " + y) ; 

} 

public Point ( ) 

{ this (0,0) ; // appel Point (0,0) ; doit etre la premiere instruction 
System. out. println ("constructeur sans argument") ; 

} 

private int x, y ; 

} 

public class Consthis 

{ public static void main (String args[ ] ) 
{ Point a = new Point (1, 2) ; 
Point b = new Point ( ) ; 

} 

} 
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constructeur deux arguments : 1 2 
constructeur deux arguments : 0 0 
constructeur sans argument 

Exemple d'appel d'un constructeur au sein d'un autre constructeur 
D'une maniere generale : 



Lappel this(...) doit obligatoirement etre la premiere instruction du 
constructeur. 



10 La recursivite des methodes 

Java autorise la recursivite des appels de methodes. Celle-ci peut etre : 

• directe : une methode comporte, dans sa definition, au moins un appel a elle-meme ; 

• croisee : 1' appel d'une methode entraine 1' appel d'une autre methode qui, a son tour, appelle 
la methode initiale (le cycle pouvant d'ailleurs faire intervenir plus de deux methodes). 

On peut appliquer la recursivite aussi bien aux methodes usuelles qu'aux methodes de classes 
(statiques). Voici un exemple classique d'une methode statique calculant une factorielle de 
facon recursive : 



class Dtil 

{ public static long fac (long n) 
{ if (n>l) return (fac(n-l) * n) ; 
else return 1 ; 

} 

} 



public class TstFac 

{ public static void main (String [ ] args) 
{ int n ; 

System. out. print ("donnez un entier positif : ") ; 
n = Clavier . lirelnt () ; 

System. out .println ("Voici sa factorielle : " + Util.fac(n) ) ; 

} 

) 



donnez un entier positif : 8 
Voici sa factorielle : 40320 



Exemple d' utilisation d'une methode (statique) recursive de calcul de factorielle 
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II faut bien voir qu'un appel de la methode fac entraine une allocation d'espace pour les 
eventuelles variables locales (ici, il n'y en a aucune), l'argument n et la valeur de retour. Or 
chaque nouvel appel fac, a l'interieur de fac, provoque une telle allocation, sans que les 
emplacements precedents n'aient ete liberes. 

II y a done une sorte d'empilement des espaces alloues aux informations gerees par la 
methode, parallelement a un empilement des appels de la methode. Ce n'est que lors de 
l'execution de la premiere instruction return que Ton commencera a "depiler" les appels et 
les emplacements, done a liberer de l'espace memoire. 

Voici comment vous pourriez modifier la methode fac pour qu'elle vous permette de suivre 
ses differents empilements et depilements : 

class Util 

{ public static long fac (long n) 
{ long res ; 

System. out. println ("** entree dans fac : n = " + n) ; 
if (n<=l) res = 1 ; 

else res = fac(n-l) * n ; 
System. out. println ("** sortie de fac : res = " + res) ; 
return res ; 

} 

} 

public class TstFac2 

{ public static void main (String [ ] args) 
{ int n ; 

System. out. print ("donnez un entier positif : ") ; 
n = Clavier . lirelnt () ; 

System . out . println ("Voici sa factorielle : " + Util. fac (n) ) ; 

} 

} 



donnez un 


entier positif 




5 


** 


entree 


dans fac 


n = 


5 




** 


entree 


dans fac 


n = 


4 




** 


entree 


dans fac 


n = 


3 




** 


entree 


dans fac 


n = 


2 




** 


entree 


dans fac 


n = 


: 




** 


sortie 


de fac 




res 




l 


** 


sortie 


de fac 




res 




2 


** 


sortie 


de fac 




res 




6 


** 


sortie 


de fac 




res 




24 


** 


sortie 


de fac 




res 




120 



Voici sa factorielle : 120 



Suivi des empilements et depilements des appels d'unefonction recursive 
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Remarque 

Nous n'avons programme la methode fac sous forme recursive que pour l'exemple. II est 
clair qu'elle pourrait etre ecrite de maniere iterative classique : 

public static long fac (long n) 
{ long res=l ; 

for (long i=l ; i<=n ; i++) 
res *= i ; 

return res ; 

} 

Une methode recursive est generalement moins efficace (en temps et en espace 
memoire) qu'une methode iterative. II est conseille de ne recourir a une demarche 
recursive que lorsqu'on ne trouve pas de solution iterative evidente. 

1 1 Les objets membres 

Comme nous l'avons souligne a plusieurs reprises, les champs d'une classe sont soit d'un 
type primitif, soit des references a des objets. Dans le second cas, on parle souvent d'objet 
membre pour caracteriser cette situation qui peut etre facilement mise en ceuvre avec ce qui a 
ete presente auparavant. Nous allons ici commenter un exemple pour mettre 1' accent sur cer- 
tains points qui peuvent s'averer fondamentaux en conception objet. Cet exemple servira 
egalement d'element de comparaison entre la notion d'objet membre et celle de classe 
interne presentee un peu plus loin. 

Supposons done que nous disposions d'une classe Point classique 1 : 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; 
this .y = y ; 

} 

public void afficheO 

{ System. out .println ("Je suis un point de coordonnees " + x + " " + y) ; 
} 

private int x, y ; 

} 

Imaginons que nous souhaitions creer une classe Cercle permettant de representer des cercles 
definis par un centre, objet du type Point precedent, et un rayon (flottant). Par souci de simpli- 
fication, nous supposerons que les fonctionnalites de notre classe Cercle se reduisent a : 

• l'affichage des caracteristiques d'un cercle (coordonnees du centre et rayon), 



1. Si la notation this.x ne vous est pas familiere, revoyez le paragraphe 9.5.2. 
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• le deplacement de son centre. 

Nous pouvons envisager que notre classe Cercle se presente ainsi : 

class Cercle 

{ public Cercle (int x, int y, float r) { } // constructeur 

public void afficheO { } 

public void deplace (int dx, int dy) { } 

private Point c ; // centre du cercle 
private float r ; // rayon du cercle 

} 

L'ecriture du constructeur ne pose pas de probleme ; nous pouvons proceder ainsi 1 : 

public Cercle (int x, int y, float r) 
{ c = new Point (x, y) ; 
this.r = r ; 

} 

En ce qui concerne la methode affiche de la classe Cercle, nous pourrions esperer proceder 
ainsi : 

public void afficheO 
{ System. out. println ("Je suis un cercle de rayon " + r ) ; 
System . out . print (" et de centre ") ; 
c. afficheO ; 

} 

En fait, cette methode affiche r information relative a un cercle de la maniere suivante (ici, il 
s'agit d'un cercle de coordonnees 1, 2 et de rayon 5.5) : 

Je suis un cercle de rayon 5 . 5 

et de centre Je suis un point de coordonnees 1 2 

Certes, on trouve bien toute F information voulue, mais sa presentation laisse a desirer. 
Quant a la methode deplace, il n'est pas possible de l'ecrire ainsi : 

void deplace (int dx, int dy) 

{ c.x += dx ; // x n' est pas un champ public de la classe Point ; 
// on ne peut done pas acceder a c.x 
c.y += dy ; // idem 

} 

En effet, seules les methodes d'une classe peuvent acceder aux champs prives d'un objet de 
cette classe. Or deplace est une methode de Centre ; ce n'est pas une methode de la classe 
Point 2 . 

Pour pouvoir realiser la methode deplace, il faudrait que la classe Point dispose : 

• soit d'une methode de deplacement d'un point, 

• soit de methodes d'acces et de methodes d' alteration. 



1. Si la notation this.r ne vous est pas familiere, revoyez le paragraphe 9.5.2. 

2. Notez que s'il en allait autrement, sous pretexte que la classe Cercle dispose d'un membre de type Point, il 
suffirait de creer artificiellement des membres dans une methode pour pouvoir violer le principe 
d'encapsulation ! 
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Par exemple, si Point disposait des methodes d'acces getX et getY et des methodes d' altera- 
tion setXet setY, la methode deplace de Cercle pourrait s'ecrire ainsi : 

public void deplace (int dx, int dy) 
{ c.setX (c.getXO + dx) ; 
c.setY (c.getYO + dy) ; 

} 

Cet exemple montre bien qu'il est difficile de realiser une bonne conception de classe, c'est-a-dire 
de definir le bon contrat. Seul un contrat bien specifie permettra de juger de la possibilite d'utiliser 
ou non une classe donnee. Bien stir, Fexemple est ici suffisamment simple pour que la liste de la 
classe Point puisse tenir lieu de contrat, ou encore pour que Ton definisse la classe Cercle, sans 
recourir a la classe Point. 

A titre indicatif, voici un programme complet utilisant une classe Cercle possedant un objet mem- 
bre de type Point, cette derniere etant dotee des fonctions d'acces et d' alteration necessaires : 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 

} 

public void afficheO 

{ System. out .println ("Je suis un point de coordonnees " + x + " " + y) ; 
} 

public int getX() { return x ; } 
public int getY() { return y ; } 
public void setX (int x) { this.x = x ; } 
public void setY (int y) { this.y = y ; } 
private int x, y ; 

) 

class Cercle 

{ public Cercle (int x, int y, float r) 
{ c = new Point (x, y) ; 
this.r = r ; 

} 

public void afficheO 

{ System. out .println ("Je suis un cercle de rayon " + r) ; 
System. out. println (" et de centre de coordonnees " 
+ c.getXO + " " + c.getYO) ; 

} 

public void deplace (int dx, int dy) 

{ c.setX (c.getXO + dx) ; c.setY (c.getYO + dy) ; 

} 

private Point c ; // centre du cercle 
private float r ; // rayon du cercle 

} 

public class TstCerc 

{ public static void main (String args[ ] ) 

{ Point p = new Point (3, 5) ; p. afficheO ; 

Cercle c = new Cercle (1, 2, 5.5f) ; c. afficheO; 

} 

) 
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Je suis un point de coordonnees 3 5 
Je suis un cercle de rayon 5 . 5 
et de centre de coordonnees 1 2 



Exemple d'une classe Cercle comportant un objet membre de type Point 




Remarque 



La situation d'objet membre correspond a ce ce qu'on nomme generalement la relation a 
(appartenance). Nous verrons que la situation d'heritage correspond a la relation est 2 . 



La notion de classe interne a ete introduite par la version 1 . 1 de Java, essentiellement dans le 
but de simplifier l'ecriture du code de la programmation evenementielle. Sa presentation ici 
se justifie par son lien avec le reste du chapitre et aussi parce que Ton peut utiliser des classes 
internes en dehors de la programmation evenementielle. Mais son etude peut tres bien etre 
differee jusqu'au chapitre 12. Et meme la, si vous le desirez, vous pourrez vous contenter 
d'exploiter un schema de classe anonyme que nous vous presenterons alors (cette notion fon- 
dee en partie sur celle de classe interne, utilise en plus Fune des deux notions d'heritage ou 
d'interface). 



Une classe est dite interne lorsque sa definition est situee a l'interieur de la definition d'une 
autre classe. Malgre certaines ressemblances avec la notion d'objet membre etudiee ci-des- 
sus, elle ne doit surtout pas etre confondue avec elle, meme s'il est possible de Putiliser dans 
ce contexte. 

La notion de classe interne correspond a cette situation : 

class E // definition d' une classe usuelle (dite alors externe) 

{ // methodes et donnees de la classe E 

class I // definition d' une classe interne a la classe E 

{ // methodes et donnees de la classe I 



12 



Les classes internes 



12.1 Imbrication de definitions de classe 



// autres methodes et donnees de la classe E 



1. En anglais has a. 

2. En anglais is a. 
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II est tres important de savoir que la definition de la classe / n'introduit pas d' office de mem- 
bre de type / dans E. En fait, la definition de / est utilisable au sein de la definition de E, pour 
instancier quand on le souhaite un ou plusieurs objets de ce type. Par exemple, on pourra ren- 
contrer cette situation : 

class E 

{ public void fe() // methode de E 

{ I i = new I() ; // creation d' un objet de type I ; sa reference est 

// ici locale a la methode fe 

} 

class I 



Premier schema a" utilisation de classe interne 

On voit qu'ici un objet de classe E ne contient aucun membre de type /. Simplement, une de 
ses methodes (fe) utilise le type / pour instancier un objet de ce type. 

Mais bien entendu, on peut aussi trouver une ou plusieurs references a des objets de type / au 
sein de la classe E, comme dans ce schema : 

class E 

{ 

class I 



private I il, i2 ; // les champs il et i2 de E sont des references 
/ / a des obj ets de type I 



Second schema d' utilisation de classe interne 

Ici, un objet de classe E contient deux membres de type /. Nous n'avons pas precise comment 
les objets correspondants seront instancies (par le constructeur de E, par une methode de 
£...). 



12.2 Lien entre objet interne et objet externe 



On peut se demander en quoi les situations precedentes different d'une definition de / qui 
serait externe a celle de E. En fait, les objets correspondant a cette situation de classe interne 
jouissent de trois proprietes particulieres. 

1. Un objet d'une classe interne est toujours associe, au moment de son instanciation, 
a un objet d'un classe externe dont on dit qu'il lui a donne naissance. Dans le pre- 
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mier schema ci-dessus, l'objet de reference ; sera associe a Fobjet de type E auquel 
sera appliquee la methode/e ; dans le second schema, rien n'est precise pour l'ins- 
tant pour les objets de reference il et z'2. 

2. Un objet d'une classe interne a toujours acces aux champs et methodes (meme pri- 
ves) de l'objet externe lui ayant donne naissance (attention : ici, il s'agit bien d'un 
acces restreint a l'objet, et non a tous les objets de cette classe). 

3. Un objet de classe externe a toujours acces aux champs et methodes (meme prives) 
d'un objet d'une classe interne auquel il a donne naissance. 

Si le point 1 n'apporte rien de nouveau par rapport a la situation d' objets membres, il n'en va 
pas de meme pour les points 2 et 3, qui permettent d'etablir une communication privilegiee 
entre objet externe et objet interne. 

Exemple 1 

Voici un premier exemple utilisant le premier schema du paragraphe 12.2 et illustrant les 
points 1 et 2 : 

class E 

{ public void f e ( ) 

{ 11 = new I() ; // creation cf un objet de type I, associe a 1' objet 
// de classe E lui ayant donne naissance (celui qui 
// aura appele la methode fe) 

} 

class I 

{ 

public void fi () 

{ // ici, on a acces au champ ne de 1' objet de classe E 

// associe a 1' objet courant de classe I 

} 

private int ni ; 

) 

private int ne ; // champ prive de E 

} 



E el = new E(), e2 = new E() ; 

el.feO ; // l'objet cree par fe sera associe a el 

// dans fi, ne designera el.n 
e2.fe() ; // l'objet cree par fe sera associe a e2 

// dans fi, ne designera e2.n 

Exemple 2 

Voici un second exemple utilisant le second schema du paragraphe 12.2 et illustrant les points 
1 et 3 : 
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class E 

{ public void E () 
{ il = new I() ; J 
public void fe() 
{ i2 = new I() ; } 
public void g () 

{ // ici, on peut acceder non seulement a il et i2, 

// mais aussi a il.ni ou i2.ni 

} 

class I 

{ 

private int ni ; 

} 

private I il, i2 ; // les champs il et i2 de E sont des references 
/ / a des ob j ets de type I 

} 



E el = new E() ; // ici, le constructeur de el cree un objet de type I 

// associe a el et place sa reference dans el.il (ici prive) 

E e2 = new E() ; // ici, le constructeur de e2 cree un objet de type I 

// associe a el et place sa reference dans e2.il (ici prive) 

el.feO ; // la methode fe cree un objet de type I associe a el 

// et place sa reference dans el.i2 

Au bout du compte, on a cree ici deux objets de type 7, associes a el ; il se trouve que (apres 
appel de/e seulement), leurs references figurent dans el.il et el.i2. La situation ressemble a 
celle d' objets membres (avec cependant des differences de droits d'acces). En revanche, on 
n'a cree qu'un seul objet de type I associe a e2. 

Remarques 

1 Une methode statique n'est associee a aucun objet. Par consequent, une methode statique 
d'une classe externe ne peut creer aucun objet d'une classe interne. 

2 Une classe interne ne peut pas contenir de membres statiques. 

12.3Exemple complet 

Au paragraphe 11, nous avons commente un exemple de classe Cercle utilisant un objet 
membre de type Point. Nous vous proposons ici, a simple titre d'exercice, de creer une telle 
classe en utilisant une classe nommee Centre, interne a Cercle : 



class Cercle 

{ class Centre // definition interne a Cercle 
{ public Centre (int x, int y) 
{ this.x = x ; this.y = y ; 
} 
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public void afficheO 

{ System. out. println (x + ", " + y) ; 

} 

private int x, y ; 

} 

public Cercle (int x, int y, double r) 
{ c = new Centre (x, y) ; 
this.r = r ; 

} 

public void affiche () 

{ System . out . print ("cercle de rayon " + r + " de centre ") ; 
c. afficheO ; 

} 

public void deplace (int dx, int dy) 

{ c.x += dx ; c.y += dy ; // ici, on a bien acces a x et y 
} 

private Centre c ; 
private double r ; 



public class TstCercl 

{ public static void main (String args[ ] ) 
{ Cercle cl = new Cercle (1, 3, 2.5) ; 
cl. afficheO ; 
cl. deplace (4, -2) ; 
cl. afficheO ; 

} 

} 



cercle de rayon 2 . 5 de centre 1 , 3 
cercle de rayon 2 . 5 de centre 5 , 1 



Classe Cercle utilisant une classe interne Centre 



0 



Ici, la classe Centre a ete dotee d'une methode affiche, reutilisee par la methode affiche de la 
classe Cercle. La situation de classe interne ne se distingue guere de celle d'objet membre. 
En revanche, bien que la classe Centre ne dispose ni de fonctions d' acces et d' alteration, ni 
de methode deplace, la methode deplace de la classe Cercle a bien pu acceder aux champs 
prives x et y de Fobjet de type Centre associe. 



Informations complementaires 

Nous venons de vous presenter l'essentiel des proprietes des classes internes. Voici quel- 
ques complements concernant des possibilites rarement exploiters. 
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Declaration et instanciation d'un objet d'une classe interne 

Nous avons vu comment declarer et instancier un objet d'une classe interne depuis une classe 
englobante, ce qui constitue la demarche la plus naturelle. En theorie, Java permet d'utiliser 
une classe interne depuis une classe independante (non englobante). Mais, il faut quand 
meme rattacher un objet d'une classe interne a un objet de sa classe englobante, moyen- 
nant l'utilisation d'une syntaxe particuliere de new. Supposons que Ton ait : 

public class E // classe englobante de I 

{ 

public class I // classe interne a E 

{ 

} 

} 

En dehors de E, vous pouvez toujours declarer une reference a un objet de type /, de cette 
maniere : 

E.I i ; // reference a un objet de type I (interne a E) 

Mais la creation d'un objet de type / ne peut se faire qu'en le rattachant a un objet de sa 
classe englobante. Par exemple, si Ton dispose d'un objet e cree ainsi : 

E e = new E ( ) ; 

on pourra affecter a ; la reference a un objet de type /, rattache a e, en utilisant new comme 
suit : 

i = new e.I() ; // creation d' un objet de type I, rattache a 1' objet e 
// et affectation de sa reference a i 

Classes internes locales 

Vous pouvez definir une classe interne / dans une mefhode /d'une classe E. Dans ce cas, 
1' instanciation d'objets de type / ne peut se faire que dans/. En plus des acces deja decrits, un 
objet de type / a alors acces aux variables locales finales de/. 

public class E 

{ 

void f () 

{ final int n=15 ; float x ; 

class I // classe interne a E, locale a f 

{ // ici, on a acces a n, pas a x 

} 

I i = new I() ; // classique 

} 

} 

Classes internes statiques 

Les objets des classes internes dont nous avons parle jusqu'ici etaient toujours associes a un 
objet d'une classe englobante. On peut creer des classes internes "autonomes" en employant 
l'attribut static : 
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public class E 



// classe englobante 



public static class I 



// definition (englobee dans celle de E) 
// d une classe interne autonome 



} 

Depuis l'exterieur de E, on peut instancier un objet de classe / de cette facon : 

E . I i = new E . I () ; 

L' objet i n'est associe a aucun objet de type E. Bien entendu, la classe / n'a plus acces aux 
membres de E, sauf s'il s'agit de membres statiques. 



La notion de paquetage correspond a un regroupement logique sous un identificateur com- 
mun d'un ensemble de classes. Elle est proche de la notion de bibliotheque que Ton rencon- 
tre dans d'autres langages. Elle facilite le developpement et la cohabitation de logiciels 
consequents en permettant de repartir les classes correspondantes dans differents paquetages. 
Le risque de creer deux classes de meme nom se trouve alors limite aux seules classes d'un 
meme paquetage. 



Un paquetage est caracterise par un nom qui est soit un simple identificateur, soit une suite 
d'identificateurs separes par des points, comme dans : 

MesClasses 

Utilitaires.Mathematiques 
Utilitaires.Tris 

L attribution d'un nom de paquetage se fait au niveau du fichier source ; toutes les classes 
d'un meme fichier source appartiendront done toujours a un meme paquetage. Pour ce faire, 
on place, en debut de fichier, une instruction de la forme : 

package xxxxxx ; 

dans laquelle xxxxxx represente le nom du paquetage. 

Cette instruction est suffisante, meme lorsque le fichier concerne est le premier auquel on 
attribue le nom de paquetage en question. En effet, la notion de paquetage est une notion 
"logique", n'ayant qu'un rapport partiel avec la localisation effective des classes ou des 
fichiers au sein de repertoires 1 . 



13 Les paquetages 



13.1 Attribution d'une classe a un paquetage 



1 . Certains environnements peuvent cependant imposer des contraintes quant aux noms de repertoires et a leur 
localisation. 
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De meme, lorsqu'on recourt a des noms de paquetages hierarchises (comme Utilitaires.Tris), 
il ne s'agit toujours que d'une facilite d'organisation logique des noms de paquetage. En 
effet, on ne pourra jamais designer simultanement deux paquetages tels que Utilitai- 
res.Mathematiques et Utilitaires.Tris en se contentant de citer Utilitaires. Qui plus est, ce 
dernier pourra tres bien correspondre a d'autres classes, sans rapport avec les precedentes. 

En l'absence d'instruction package dans un fichier source, le compilateur considere que les 
classes correspondantes appartiennent au paquetage par defaut. Bien entendu, celui-ci est 
unique pour une implementation donnee. 



13.2 Utilisation d'une classe d'un paquetage 

Lorsque, dans un programme, vous faites reference a une classe, le compilateur la recherche 
dans le paquetage par defaut. Pour utiliser une classe appartenant a un autre paquetage, il est 
necessaire de fournir l'information correspondante au compilateur. Pour ce faire, vous 
pouvez : 

• citer le nom du paquetage avec le nom de la classe, 

• utiliser une instruction import en y citant soit une classe particuliere d'un paquetage, soit 
tout un paquetage. 

En citant le nom de la classe 

Si vous avez attribue a la classe Point le nom de paquetage MesClasses par exemple, vous 
pourrez l'utiliser simplement en la nommant MesClasses. Point. Par exemple : 

MesClasses . Point p = new MesClasses .Point (2, 5) ; 

p.afficheO ; // ici, le nom de paquetage n' est pas requis 
Evidemment, cette demarche devient fastidieuse des que de nombreuses classes sont conce- 
rnees. 

En important une classe 

L' instruction import vous permet de citer le nom (complet) d'une ou plusieurs classes, par 
exemple : 

import MesClasses .Point, MesClasses .Cercle ; 
A partir de la, vous pourrez utiliser les classes Point et Cercle sans avoir a mentionner leur 
nom de paquetage, comme si elles appartenaient au paquetage par defaut. 

En important un paquetage 

La demarche precedente s'avere elle aussi fastidieuse des qu'un certain nombre de classes 
d'un meme paquetage sont concemees. Avec : 

import MesClasses.* ; 
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vous pourrez ensuite utiliser toutes les classes du paquetage MesClasses en omettant le nom 
de paquetage correspondant. 

Precautions 

L' instruction : 

import MesClasses ; 

ne concerne que les classes du paquetage MesClasses. Si, par exemple, vous avez cree 
un paquetage nomme MesClasses. Projetl , ses classes ne seront nullement concernees. 

Remarques 

1 En citant tout un paquetage dont certaines classes sont inutilisees, vous ne vous penalise- 
rez ni en temps de compilation, ni en taille des byte codes, Bien entendu, si vous devez 
creer deux paquetages contenant des classes de meme nom, cette demarche ne sera plus 
utilisable (importer deux classes de meme nom constitue une erreur). 

2 La plupart des environnements imposent des contraintes quant a la localisation des 
fichiers correspondant a un paquetage (il peut s'agir de fichiers separes, mais aussi 
d'archives JAR ou ZIP). En particulier, un paquetage de nom X. Y.Z se trouvera toujours 
integralement dans un sous -repertoire de nom X.Y.Z (les niveaux superieurs etant quel- 
conques). En revanche, le paquetage X.Y.U pourra se trouver dans un sous-repertoire 
X.Y.U rattache a un repertoire different du precedent. Avec le SDK 1 de SUN, la recher- 
che d'un paquetage (y compris celle du paquetage courant) se fait dans les repertoires 
declares dans la variable d'environnement CLASSPATH (le point y designe le repertoire 
courant). 

13.3 Les paquetages standard 

Les nombreuses classes standard avec lesquelles Java est fourni sont structurees en paqueta- 
ges. Nous aurons l'occasion d'utiliser certains d'entre eux par la suite, par exemple java.awt, 
java.awt. event, javax.swing... 

Par ailleurs, il existe un paquetage particulier nomme javaJang qui est automatiquement 
importe par le compilateur. C'est ce qui vous permet d'utiliser des classes standard telles que 
Math, System, Float ou Integer, sans avoir a introduire d' instruction import. 



1. Nouveau nom du JDK depuis Java 1.3. 
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13.4Paquetages et droits d'acces 

13.4.1 Droits d'acces aux classes 

Pour vous permettre de commencer a ecrire de petits programmes, nous vous avons deja 
signale qu'un fichier source pouvait contenir plusieurs classes, mais qu'une seule pouvait 
avoir l'attribut public. C'est d'ailleurs ainsi que nous avons procede dans bon nombre 
d'exemples. 

D'une maniere generale, chaque classe dispose de ce qu'on nomme un droit d'acces (on dit 
aussi un modificateur d'acces). II permet de decider quelles sont les autres classes qui peu- 
vent l'utiliser. II est simplement defini par la presence ou F absence du mot-cle public : 

• avec le mot-cle public, la classe est accessible a toutes les autres classes (moyennant even- 
tuellement le recours a une instruction import) ; 

• sans le mot-cle public, la classe n'est accessible qu'aux classes du meme paquetage. 

Tant que Ton travaille avec le paquetage par defaut, l'absence du mot public n'a guere 
d' importance (il faut toutefois que la classe contenant main soit publique pour que la 
machine virtuelle y ait acces). 

13.4.2 Droits d'acces aux membres d'une classe 

Nous avons deja vu qu'on pouvait utiliser pour un membre (champ ou methode) l'un des 
attributs public ou private. Avec public, le membre est accessible depuis l'exterieur de la 
classe ; avec private, il n'est accessible qu'aux methodes de la classe. En fait, il existe une 
troisieme possibility, a savoir l'absence de mot-cle (private ou public). Dans ce cas, 1' acces 
au membre est limite aux classes du meme paquetage (on parle d'acces de paquetage). Voyez 
cet exemple : 

package PI ; package P2 ; 

public class A // accessible partout class B // accessible que de P2 
{ { 

void f 1 ( ) { } public void g ( ) 

public void f2() { } { A a ; 

} a.fl() ; // interdit 

a.f2() ; // OK 

} 

Remarques 

1 Ne confondez pas le droit d'acces a une classe avec le droit d'acces a un membre d'une 
classe, meme si certains des mots-cles utilises sont communs. Ainsi, private a un sens 
pour un membre, il n'en a pas pour une classe. 

2 Nous verrons au chapitre consacre a 1' heritage qu'il existe un quatrieme droit d'acces 
aux membres d'une classe, a savoir protected (protege). 



Informations complementaires 

Les classes internes sont concernees par ce droit d'acces, mais sa signification est diffe- 
rente 1 , compte tenu de l'imbrication de leur definition dans celle d'une autre classe : 

- avec public, la classe interne est accessible partout oil sa classe externe Test ; 

- avec private (qui est utilisable avec une classe interne, alors qu'il ne Test pas pour une 
classe externe), la classe interne n'est accessible que depuis sa classe externe ; 

- sans aucun mot-cle, la classe interne n'est accessible que depuis les classes du meme 
paquetage. 

D'une maniere generale, l'annexe A recapitule le role de ces differents droits d'acces 
pour les differentes entites que sont les classes, les classes internes, les membres et les 
interfaces. 



1. Elle s'apparente a celle qui regit les droits d'acces a des membres. 
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Les tableaux 



En programmation, on parle de tableau pour designer un ensemble d' elements de meme type 
designes par un nom unique, chaque element etant repere par un indice precisant sa position 
au sein de 1' ensemble. 

Comme tous les langages, Java permet de manipuler des tableaux mais nous verrons qu'il fait 
preuve d'originalite sur ce point. En particulier, les tableaux sont considered comme des 
objets et les tableaux a plusieurs indices s'obtiennent par composition de tableaux. 

Nous commencerons par voir comment declarer puis creer des tableaux, eventuellement les 
initialiser. Nous etudierons ensuite la maniere de les utiliser, soit au niveau de chaque ele- 
ment, soit a un niveau global. Nous examinerons alors la transmission de tableaux en argu- 
ment ou en valeur de retour d'une methode. Puis, nous aborderons la creation et Futilisation 
des tableaux a plusieurs indices. Enfin, nous parlerons de V ellipse, facilite introduite par le 
JDK 5.0 qui permet a une methode de disposer d'un nombre variable d' arguments. 

1 Declaration et creation de tableaux 

1.1 Introduction 

Considerons cette declaration : 

int t[ ] ; 

Elle precise que t est destine a contenir la reference a un tableau d'entiers. Vous constatez 
qu'aucune dimension ne figure dans cette declaration et, pour F instant, aucune valeur n'a ete 
attribute a t. Cette declaration est en fait tres proche de celle de la reference a un objet 1 . 
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On cree un tableau comme on cree un objet, c'est-a-dire en utilisant l'operateur new. On pre- 
cise a la fois le type des elements, ainsi que leur nombre (dimension du tableau), comme 
dans : 

t = new intt 5] ; // t fait reference a un tableau de 5 entiers 

Cette instruction alloue Femplacement necessaire a un tableau de 5 elements de type int et en 
place la reference dans t. Les 5 elements sont initialises par defaut (comme tous les champs 
d'un objet) a une valeur "nulle" (0 pour un int). On peut illustrer la situation par ce schema : 





0 




0 




0 




0 




0 



1 .2 Declaration de tableaux 

La declaration d'une reference a un tableau precise done simplement le type des elements du 
tableau. Elle peut prendre deux formes differentes ; par exemple, la declaration precedente : 

int t[ ] ; 

peut aussi s'ecrire : 

int [ ] t ; 

En fait, la difference entre les deux formes devient perceptible lorsque Ton declare plusieurs 
identificateurs dans une meme instruction. Ainsi, 

int [ ] tl, t2 ; // tl et t2 sont des references a des tableaux d' entiers 

est equivalent a : 

int tl[ ] , t2[ ] ; 

La premiere forme permet le melange de tableaux de type T et de variables de type T : 

int tl[ ] , n, t2[ ] ; // tl et t2 sont des tableaux d' entiers, n est entier 

En Java, les elements d'un tableau peuvent etre d'un type primitif ou d'un type objet. Par 
exemple, si nous avons defini le type classe Point, ces declarations sont correctes : 

Point tp [ ] ; // tp est une reference a un tableau d' objets de type Point 

Point a, tp[ ] , b ; // a et b sont des references a des objets de type Point 

// tp est une reference a un tableau d' objets de type Point 



1 . En particulier, elle sera soumise aux memes regies d'initialisation : valeur null s'il s'agit d'un champ d'objet, 
initialisation obligatoire avant toute utilisation dans les autres cas. 
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Une declaration de tableau ne doit pas preciser de dimensions. Cette instruction sera reje- 
tee a la compilation : 



Nous avons vu comment allouer l'emplacement d'un tableau comme celui d'un objet a l'aide 
de l'operateur new. On peut aussi utiliser un initialiseur au moment de la declaration du 
tableau, comme on le fait pour une variable d'un type primitif. 

1.3.1 Creation par l'operateur new 

La valeur de l'expression fournie a l'operateur new n'est calculee qu'au moment de l'execu- 
tion du programme. Elle peut done differer d'une fois a 1' autre, contrairement a ce qui se pro- 
duit dans le cas des langages fixant la dimension lors de la compilation. Voici un exemple : 

System. out. print ("taille voulue ? ") ; 
int n = Clavier . lirelnt () ; 
int t[ ] = new int [ n] ; 

Notez cependant que l'objet tableau une fois cree ne pourra pas voir sa taille modifiee. En 
revanche, comme n'importe quelle reference a un objet, la reference contenue dans t pourra 
tres bien evoluer au fil de l'execution et designer finalement des tableaux differents, eventuel- 
lement de tailles differentes. 

Enfin, sachez qu'il est permis de creer un tableau de taille nulle (qu'on ne confondra pas avec 
une reference nulle). En revanche, l'appel de new avec une valeur negative conduira a une 
exception NegativeArraySizeException. 

1.3.2 Utilisation d'un initialiseur 

Lors de la declaration d'une reference de tableau, on peut fournir une liste d'expressions 
entre accolades, comme dans : 



int t[ ] = { 1, n, n+p, 2*p, 12} ; 

Cette instruction cree un tableau de 5 entiers ayant les valeurs des expressions mentionnees et 
en place la reference dans t. Elle remplace les instructions suivantes : 

int n, p, t[ ] ; 



int tt 5] 



// erreur : on ne peut pas indiquer de dimension ici 



1 .3 Creation d'un tableau 



int n, p ; 



t = new intf 5] ; 

t[ 0] = 1 ; t[ 1] = n ; t[ 2] = n+p ; t[ 3] = 2*p ; t[ 4] = 12 



Mil I ilili inn 

B i i 

Java se sert du nombre d' expressions figurant dans l'initialiseur pour en deduire la taille du 
tableau a creer. Notez que ces expressions n'ont pas besoin d'etre des expressions 
constantes ; il suffit simplement qu'elles soient calculables au moment oil Ton execute Fope- 
rateur new. 

Remarque 

La notation { } n'est utilisable que dans une declaration. L' instruction suivante serait 

incorrecte : 

t = { 1, n, n+p, 2*p, 12} ; 

2 Utilisation d'un tableau 

En Java, on peut utiliser un tableau de deux facons differentes : 

• en accedant individuellement a chacun de ses elements, 

• en accedant globalement a F ensemble du tableau. 

2.1 Acces individuel aux elements d'un tableau 

On peut manipuler un element de tableau comme on le ferait avec n'importe quelle variable 
ou n'importe quel objet du type de ses elements. On designe un element particulier en placant 
entre crochets, a la suite du nom du tableau, une expression entiere nommee indice indiquant 
sa position. Le premier element correspond a F indice 0 (et non 1). 

int t[ ] = new int[ 5] ; 

t[ 0] = 15 ; // place la valeur 15 dans le premier element du tableau t 

t[ 2] ++ ; // incremente de 1 le troisieme element de t 

System. out. println (t[ 4] ) ; // affiche la valeur du dernier element de t 

Si, lors de F execution, la valeur d'un indice est negative ou trop grande par rapport a la taille 
du tableau, on obtient une erreur d'execution. Plus precisement, il y a declenchement d'une 
exception de type ArraylndexOutOfBoundsException. Nous apprendrons au chapitre 10 qu'il 
est possible d'intercepter une telle exception. Si nous le faisons pas, nous aboutissons simple- 
ment a F arret de l'execution du programme ; en fenetre console s'afHchera un message 
d' erreur. 

Voici un exemple complet de programme utilisant un tableau de flottants pour determiner le 
nombre d'eleves d'une classe ayant une note superieure a la moyenne de la classe 1 . 



1. Notez bien que s'il s'agissait seulement de determiner la moyenne de la classe, il ne serait pas indispensable 
d'utiliser un tableau. 
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public class Moyenne 

{ public static void main (String args! ] ) 
{ int i, nbEl, nbElSupMoy ; 
double somme ; 
double moyenne ; 

System. out. print ("Combien d' eleves ") ; 
nbEl = Clavier . lirelnt () ; 
double notes! ] = new doublet nbEl] ; 
for (i=0 ; KnbEl ; i++) 

{ System. out. print ("donnez la note numero " + (i+1) + " : " ) ; 
notesf i] = Clavier. lireDouble () ; 

} 

for (i=0, somme=0 ; KnbEl ; i++) somme += notes[ i] ; 
moyenne = somme / nbEl ; 

System. out. println ("\nmoyenne de la classe " + moyenne) ; 
for (i=0, nbElSupMoy=0 ; KnbEl ; i++ ) 

if (notes[ i] > moyenne) nbElSupMoy+t ; 
System. out. println (nbElSupMoy + " eleves ont plus de cette moyenne") ; 

} 

} 



Combien d' 


eleves 5 






donnez 


la 


note 


numero 


1 


12 


donnez 


la 


note 


numero 


2 


14.5 


donnez 


la 


note 


numero 


3 


10 


donnez 


la 


note 


numero 


4 


9 


donnez 


la 


note 


numero 


5 


16 



moyenne de la classe 12.3 

2 eleves ont plus de cette moyenne 

Exemple d' utilisation d'un tableau 

Vous constatez que la possibility de definir la dimension du tableau au moment de sa creation 
permet de travailler avec un nombre d'eleves quelconques. 

2.2 Affectation de tableaux 

Le paragraphe precedent vous a montre comment acceder individuellement a chacun des ele- 
ments d'un tableau existant. Java permet aussi de manipuler globalement des tableaux, par le 
biais d' affectations de leurs references. 

Considerons ces instructions qui creent deux tableaux d'entiers en placant leurs references 
dans tl et t2 : 

int [ ] tl = new int[ 3] ; 

for (int i=0 ; i<3 ; i++) tl[ i] = i ; 

int [ ] t2 = new int[ 2] ; 

for (int i=0 ; i<2 ; i++) t2[ i] = 10 + i ; 
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La situation peut etre schematisee ainsi : 




0 



2 



10 
11 



Executons maintenant F affectation : 

tl = t2 ; // la reference contenue dans t2 est recopiee dans tl 
Nous aboutissons a cette situation : 

0 
1 

2 



tl 



a 




10 

n 



Dorenavant, tl et t2 designent le meme tableau. Ainsi, avec : 

tl[ 1] = 5 ; 

System. out. println (t2[ 1] ) ; 

on obtiendra l'affichage de la valeur 5, et non 10. 

Si Fobjet que constitue le tableau de trois entiers anciennement designe par tl n'est plus refe- 
rence par ailleurs, il deviendra candidat au ramasse-miettes. 

II est tres important de noter que 1' affectation de references de tableaux n'entraine aucune 
recopie des valeurs des elements du tableau. On retrouve exactement le meme phenomene 
que pour l'affectation d'objets. 
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Remarques 

1 Un objet tableau tel que celui cree par new int[3] a une dimension fixee pour toute la 
duree du programme (meme si celle-ci est fixee lors de l'execution). En revanche, l'objet 
reference par tl pouvant evoluer au fil de l'execution, sa dimension peut elle aussi evo- 
luer. Cependant, il ne s'agit pas de tableaux dynamiques au sens usuel du terme. De tels 
tableaux peuvent etre obtenus en Java en recourant a la classe Vector du paquetage 
java.util. 

2 Si les elements de deux tableaux ont des types compatibles par affectation, les referen- 
ces correspondantes ne sont pas pour autant compatibles par affectation. Si Ton consi- 
dere par exemple : 

int te[] tEnt ; 
float tf [ ] tFlot ; 

il n'est pas possible d'ecrire : 

tFlot = tEnt ; 

et ce, bien qu'un int puisse etre affecte a un float. 

En revanche, une telle compatibilite existera entre un tableau d'objets d'une classe et 
un tableau d'objets de sa classe de base, comme nous le verrons au chapitre consacre a 
l'heritage. 

2.3 La taille d'un tableau : length 

La declaration d'une reference de tableau n'en precise pas la taille et nous avons vu que cette 
derniere peut evoluer au fil de l'execution d'un programme. Le champ length permet de con- 
naitre le nombre d' elements d'un tableau de reference donnee : 

int t[ ] = new int[ 5] ; 

System. out. println ("taille de t : " + t. length) ; // affiche 5 
t = new intt 3] ; 

System. out. println ("taille de t : " + t. length) ; // affiche 3 

\^^~ Remarque 

Notez bien qu'on ecrit t.length et non t.lengthf) car length s'utilise comme s'il s'agissait 
d'un champ public de l'objet tableau t et non d'une methode. 

2.4 Exemple de tableau d'objets 

Comme nous l'avons deja dit, les elements d'un tableau peuvent etre de type quelconque, et 
pas seulement d'un type primitif comme dans nos precedents exemples. Voici un exemple de 
programme utilisant un tableau d'objets de type Point : 
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public class TabPoint 

{ public static void main (String args[ ] ) 
{ Point [ ] tp ; 

tp = new Point! 3] ; 
tpl 0] = new Point (1, 2) ; 
tpl 1] = new Point (4, 5) ; 
tpl 2] = new Point (8, 9) ; 
for (int i=0 ; i<tp. length ; i++) 
tp[ i] .afficheO ; 

} 

} 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 

} 

public void affiche () 

{ System. out .println ("Point : " + x + ", " + y) ; 

} 

private int x, y ; 

} 

Point : 1, 2 
Point : 4, 5 
Point : 8, 9 

Exemple d' utilisation d'un tableau d'objets (de type Point) 

2.5 Utilisation de la boucle for... each (JDK 5.0) 

Le JDK 5.0 a introduit une nouvelle structure de controle adaptee aux collections, aux 
tableaux et aux chaines. Par exemple, si Ton dispose d'un tableau t declare ainsi : 

double t [ ] ; 
Avec cette cette instruction : 

for (double v : t) System. out .println (v) ; 

la variable v prendra successivement les differentes valeurs du tableau t. On obtiendra le 
meme resultat qu'en utilisant : 

for (int i = 0 ; i<t. length ; i++) System. out. println (t[ i] ) ; 

II faut toutefois bien voir que cette structure for... each ne s'applique qu'a des consulta- 
tions de valeurs, et en aucun cas a des modifications. Ainsi, avec cette instruction : 

for (double v : t) v = 0 ; // correct mais ne fait probablement pas ce qu' on attend 

on laisse les valeurs de t inchangees ; on s'est contente de mettre a 0 la valeur v a chaque tour 
de boucle... 
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Ainsi Futilisaion systematique de cette structure dans le cas de tableaux risque souvent de 
conduire a des codes heterogenes melangeant des boucles for classiques avec des boucles 
for... each. 

2.6 Cas particulier des tableaux de caracteres 

Considerez cette situation : 

char [ ] tc ; 
int [ ] ti ; 

System. out. println (tc) ; //on obtient bien les valeurs des caracteres de tc 
System. out. println (ti) ; // on n' obtient pas les valeurs des entiers de ti 

Le premier affichage est satisfaisant, le second ne Test pas. En fait,la methode println (il en 
irait de meme pour print) est surdefinie pour des tableaux de caracteres. Elle ne Test pas pour 
les autres tableaux, de sorte que, dans le second cas, il y a appel de la methode toString de la 
classe tableau correspondante. 

Qui plus est, l'instruction suivante : 

System. out. println ("tc = " + tc) ; 

ne fournira pas de resultat satisfaisant car la presence de la chaine entrainera la conversion de 
tc en chaine. 

3 Tableau en argument ou en retour 

Lorsqu'on transmet un nom de tableau en argument d'une methode, on transmet en fait (une 
copie de) la reference au tableau. La methode agit alors directement sur le tableau concerne 
et non sur une copie. On retrouve exactement le meme phenomene que pour les objets (para- 
graphe 9.3 du chapitre 6). 

Voici un exemple de deux methodes statiques (definies dans une class utilitaire nommee Util) 
permettant : 

• d'afficher les valeurs des elements d'un tableau d'entiers (methode affiche), 

• de mettre a zero les elements d'un tableau d'entier (methode raz). 

public class TabArg 

{ public static void main (String args[ ] ) 
{ int tf] = { 1,3, 5, 7} ; 

System . out . print ("t avant : ") ; 
Util. affiche (t) ; 
Util. raz (t) ; 

System . out . print ("\nt apres : ") ; 
Util. affiche (t) ; 

} 

) 
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class Util 

{ static void raz (int t[ ] ) 

{ for (int i=0 ; i<t. length ; i++) 
t[ i] = 0 ; 

} 

static void affiche (int t[ ] ) 
{ for (int i=0 ; i<t. length ; i++) 
System. out. print (t[ i] + " ") ; 

} 

} 

t avant : 1 3 5 7 
t apres : 0 0 0 0 

Exemple de fonctions recevant un tableau en argument 

Les memes reflexions s'appliquent a un tableau fourni en valeur de retour. Par exemple, la 
methode suivante fournirait en resultat un tableau forme des n premiers nombres entiers : 

public static int[ ] suite (int n) 
{ int[ ] res = new int[ n] ; 

for (int i=0 ; i<n ; i++) res[ i] = i+1 ; // for. . . each pas applicable ici 

return res ; 

} 

Un appel de suite fournira une reference a un tableau dont on pourra eventuellement modifier 
les valeurs des elements. 

£Jf En C++ 

En C++, un tableau n'est pas un objet. II n'existe pas d'equivalent du mot-cle length. La 
transmission d'un tableau en argument correspond a son adresse ; elle est generalement 
accompagnee d'un second argument en precisant la taille (ou le nombre d' elements qu'on 
souhaite traiter a partir d'une adresse donnee, laquelle peut eventuellement correspondre 
a un element different du premier). 

4 Les tableaux a plusieurs indices 

De nombreux langages disposent de la notion de tableau a plusieurs indices. Par exemple, un 
tableau a deux indices permet de representer une matrice mathematique. 

Java ne dispose pas d'une telle notion. Neanmoins, il permet de la "simuler" en creant des 
tableaux de tableaux, c'est-a-dire des tableaux dont les elements sont eux-memes des 
tableaux. Comme nous allons le voir, cette possibilite s'avere en fait plus riche que celle de 
tableaux a plusieurs indices offerte par les autres langages. Elle permet notamment de dispo- 
ser de tableaux irreguliers, c'est-a-dire dans lesquels les differentes lignes 1 pourront etre de 
taille differente. Bien entendu, on pourra toujours se contenter du cas particulier dans lequel 
toutes les lignes auront la meme taille et, done, manipuler l'equivalent des tableaux a deux 
indices classiques. 



// ici for. . . each pas applicable 



// ou (depuis JDK 5.0) : 
// for (int v : t) System. out. print (v + 
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4.1 Presentation generale 
Premier exemple 

Ces trois declarations sont equivalentes : 

int t [ ] [ ] ; 
int [ ] t [ ] ; 
int [ ] [ ] t ; 

Elles declarent que t est une reference a un tableau, dans lequel chaque element est lui-meme 
une reference a un tableau d'entiers. Pour 1' instant, comme a l'accoutumee, aucun tableau de 
cette sorte n'existe encore. 

Mais considerons la declaration : 

int t [ ] [ ] = { new int [ 3] , new int [ 2] } ; 

L'initialiseur de t comporte deux elements dont 1'evaluation cree un tableau de 3 entiers et un 
tableau de 2 entiers. On aboutit a cette situation (les elements des tableaux d'entiers sont, 
comme d' habitude, initialises a 0) : 




0 
0 
0 



Dans ces conditions, on voit que : 

• la notation t[0] designe la reference au premier tableau de 3 entiers, 

• la notation t[0][l ] designe le deuxieme element de ce tableau (les indices commencent a 0), 

• la notation t[l ] designe la reference au second tableau de 2 entiers, 

• la notation t[l ] designe le i 6me element de ce tableau, 

• F expression t. length vaut 2, 

• l'expression t[0]. length vaut 3, 

• l'expression t[l]. length vaut 2. 



1. Malgre son ambigui'te, nous utilisons le terme ligne dans son acceptation habituelle, c'est-a-dire pour de- 
signer en fait, dans un tableau a deux indices, l'ensemble des elements ayant la meme valeur du premier indice. 
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Second exemple 

On peut aboutir a une situation tres proche de la precedente en procedant ainsi : 

int t[ ] [ ] ; 

t = new int [ 2] [ ] ; // creation cf un tableau de 2 tableaux cf entiers 

int [ ] tl = new int [ 3] ; // tl = reference a un tableau de 3 entiers 

int [ ] t2 = new int [ 2] ; // t2 = reference a un tableau de 2 entiers 

t[ 0] = tl ; t[ 1] = t2 ; // on range ces deux references dans t 

Hormis les differences concernant les instructions, on voit qu'on a cree ici deux variables 
supplementaires tl et t2 contenant les references aux deux tableaux d' entiers. La situation 
peut etre illustree ainsi : 




En C++, les elements d'un tableau a deux indices sont contigus en memoire. On peut, 
dans certains cas, considerer un tel tableau comme un (grand) tableau a un indice. Ce 
n'est pas le cas en Java. 



4.2 Initialisation 

Dans le premier exemple, nous avons utilise un initialiseur pour les deux references a intro- 
duire dans le tableau t ; autrement dit, nous avons precede comme pour un tableau a un 
indice. Mais comme on s'y attend, les initialiseurs peuvent tout a fait s'imbriquer, comme 
dans cet exemple : 

int t[ ][]={{ 1, 2, 3} , { 11, 12} } ; 
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II correspond a ce schema : 




2 
3 



4.3 Exemple 

Voici un exemple de programme complet utilisant deux methodes statiques definies dans une 
classe Util, permettant : 

• d'afficher les valeurs des elements d'un tableau d'entiers a deux indices, ligne par ligne 
(methode affiche), 

• de mettre a zero les elements d'un tableau d'entiers a deux indices (methode raz). 



class Util 
{ static void raz 
{ int i, j ; 
for (i= 0 
for (j=0 
t[ i] 



(int t[ ] [ ] ) 



i<t. length ; i++) 
; j<t[ i] .length ; j++) 
j] = 0 ; 



} 

static void affiche (int t[ ] [ ] ) 
{ int i, j ; 

for (i= 0 ; i<t. length ; i++) 

{ System. out. print ("ligne de rang 
for (j=0 ; j<t[ i] .length ; j++) 

System. out. print (t[ i] [ j] + " 
System. out. println () ; 



// for. . . each non applicable ici 

// puisque modification des valeurs de t 



// pour utiliser for. . . each 
// voir paragraphe suivant 



public class Tab2indl 

{ public static void main (String args[ ] ) 
{ int t[ ] [ ] = { { 1, 2, 3} , { 11, 12} , { 21, 
System . out . println ("t avant raz : ") ; 
Util.affiche(t) ; 
Util. raz (t) ; 

System. out. println ("t apres raz : ") ; 
Util.affiche(t) ; 



22, 23, 24} } 
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t avant raz : 
ligne de rang 0 
ligne de rang 1 
ligne de rang 2 
t apres raz : 
ligne de rang 0 
ligne de rang 1 
ligne de rang 2 



= 12 3 
= 11 12 
= 21 22 23 24 

= 000 

= 00 

= 0 0 0 0 



Exemple de methodes (statiques) recevant en argument un tableau a deux indices 

4.4 For... each et les tableaux a plusieurs indices (JDK 5.0) 

Si Ton souhaite appliquer la boucle /or... each (introduite par le JDK 5.0) aux tableaux a plu- 
sieurs indices, il est necessaire de prevoir deux boucles imbriquees, comme avec les boucles 
for usuelles. En outre, il faut tenir compte de la structure particuliere de ces tableaux. La 
methode affiche du paragraphe precedent pourrait s'ecrire ainsi : 

static void affiche (int t[ ] [ ] ) 
{ int i, j ; 

for (int[ ] ligne : t) 

{ System. out. print ("ligne = ") ; // plus de numero de ligne ici 
for (int v : ligne) 

System. out. print (v + " ") ; 
System. out. println () ; 

} 

} 

Notez cependant qu'on n' affiche pas ici le "numero de ligne" ; les resultats du programme 
precedent deviendraient : 

t apres raz : 
ligne =000 
ligne =00 
ligne =0000 

Pour obtenir ce numero, il faudrait ajouter un compteur dans la premiere boucle, ce qui com- 
pliquerait quelque peu l'ecriture : 

static void affiche (int t[ ] [ ] ) 
{ int i, j ; 

int numLigne = 0 ; // pour le numero de ligne 

for (int[ ] ligne : t) 

{ System. out. print ("ligne " + numLigne+t + " = ") ; 
for (int v : ligne) 

System. out. print (v + " ") ; 
System. out. println () ; 

} 

} 

De toute fafon, la boucle for... each reste inutilisable dans raz. 
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4.5 Cas particulier des tableaux reguliers 

Qui peut le plus peut le moins. Autrement dit, rien n'empeche que, dans un tableau a deux 
indices, toutes les lignes aient la meme taille. Par exemple, si Ton souhaite disposer d'une 
matrice de NLIG lignes et de NCOL colonnes, on pourra toujours proceder ainsi : 

int t[ ] [ ] = new int [ NLIG] [ ] ; 
int i ; 

for (i=0 ; KNLIG ; i++) t[ i] = new int[ NCOL] ; 

Mais Java permet alors d'ecrire les choses plus simplement : 

int t[ ] [ ] = new int [ NLIG] [ NCOL] ; 

Bien entendu, il est possible d'utiliser un tel tableau sans recourir au mot-cle length, comme 
dans les autres langages. Par exemple, voici comment nous pourrions mettre a zero tous les 
elements de t : 

for (int i =0 ; KNLIG ; i++) 
for (int j=0 ; j<NCOL ; j++) 
t[ i] [ j] = 0 ; 

Toutefois, il ne faudra pas perdre de vue que, meme dans ce cas, les valeurs de t comme cel- 
les de t[i] sont des references dont la valeur peut etre modifiee au cours de 1' execution. En 
particulier, lorsqu'on ecrit une methode destinee a un tel tableau regulier, on peut etre tente 
d'y utiliser classiquement un nombre de colonnes defini par exemple comme etant le nombre 
d' elements de la premiere ligne du tableau. Mais, dans ce cas, on court le risque d'appeler par 
erreur cette methode sur un tableau irregulier, avec toutes les consequences desastreuses 
qu'on peut imaginer. Les memes considerations valent si Ton cherche a transmettre NLIG et 
NCOL en arguments. 

5 Arguments variables en nombre (JDK 5.0) 

5.1 Introduction 

Depuis le JDK 5.0, on peut definir une methode dont le nombre d' arguments est variable. Par 
exemple, si Ton definit une methode somme avec Fen-tete suivant : 

int somme (int... valeurs) 

on pourra l'appeler avec un ou plusieurs arguments de type int ou meme sans argument. Voici 
quelques appels corrects de somme : 

int n, p, q ; 

somme () ; // aucun argument 

somme (n) ; // un argument de type int 

somme (n, p) ; // deux arguments de type int 

somme (n, p, q) ; // trois arguments de type int 

La notation ... utilisee dans un tel contexte se nomme souvent "ellipse". 
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Dans le corps de la methode, on accedera aux differents arguments represented par 1' ellipse 
comme s'ils avaient ete fournis sous forme d'un tableau, autrement dit comme si Ton avait 
utilise Fen-tete somme (int [] valeurs). On pourra connaitre le nombre d'arguments effectifs 
foumis lors de l'appel en recourant (comme pour un tableau) a valeurs. length. 

Voici un exemple de methode somme renvoyant la valeur de la somme des differents entiers 
recus en argument : 

static int somme (int . . . valeurs) 
{ int s = 0 ; 

for (int i=0 ; i< valeur s . length ; i++) 

s += valeurst i] ; 
return s ; 

} 

Voici une autre ecriture de somme utilisant la boucle/or... each ; le recours a length est alors 
inutile : 

static int somme (int . . . valeurs) 
{ int s = 0 ; 

for (int v : valeurs) 

s += v ; 
return s ; 

} 

Voici un petit programme complet recapitulatif : 

public class Ellipse 

{ public static void main (String args[ ] ) 
{ System. out .println (somme (2, 8, 9) ) ; 
System. out. println (somme () ) ; 
System. out .println (somme (3) ) ; 

} 

static int somme (int . . . valeurs) 
{ int s = 0 ; 

for (int v : valeurs) 
s += v ; 

return s ; 

} 

} 

19 

0 

3 

Exemple de methode a nombre d'arguments variable 

Notez bien que Fellipse concerne des arguments d'un type quelconque, classe ou primitif, 
meme si nous Favons presentee ici sur un type primitif. 
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5.2 Quelques regies concernant I'ellipse 



• Dans notre exemple introductif, I'ellipse formait le seul element de la liste d' arguments de 
Fen-tete. En fait, elle peut etre accompagnee d'autres arguments classiques, a condition de 
figurer en fin de liste et d'etre unique. Voici un exemple d'en-tete correct : 

void f (int n, float x, Point p, double. . . v) 

En revanche, ceux-ci sont incorrrects : 

void f (int n, double. . . v, float x, Point p) // Incorrect : . . . n' est pas en fin 
void f (int... vi, double... vd) // Incorrect : ... utilisee plusieurs fois 

• Nous avons vu que, dans le corps d'une methode, on utilise I'ellipse comme si Ton avait af- 
faire a un tableau. II n'y a cependant pas d' equivalence absolue entre les deux notations. 
Ainsi, avec Fen-tete : 

f (int. . . vi) 

on peut effectivement appeler/avec un tableau d'entiers, avec zero, avec un ou plusieurs 
arguments de type int. En revanche, avec Fen-tete : 

f (int[] ti) 

on ne peut appeler/qu'avec un tableau d'entiers. 

• II n'est pas possible de definir deux methodes utilisant Fune I'ellipse, Fautre un tableau 
comme dans : 

f (int. . . vi) 

f (int[ ] ti) // Erreur, meme si int... et int[ ] ne sont pas totalement equivalents 



Compte tenu des regies mentionnees ci-dessus, on voit qu'avec I'ellipse double... on peut 
utiliser des arguments effectifs de type double, double [] et meme int puiqu'alors on met- 
tra en ceuvre une conversion implicite de int en double. En revanche, si Fon prevoit dans 
Fen-tete un argument de type doublef], on ne pourra plus utiliser d' arguments effectifs de 
type int, ni meme de type int[]. 



5.3 Adaptation des regies de recherche d'une methode surdefinie 



Comme indique precedemment, il n'est pas possible de surdefinir par exemple ffint... ) et 
f(int[]). En revanche, il est tout a fait possible de surdefinir : 

f (int. . . vi) 
f (int n, int p) 

II faut alors savoir que, pour assurer la compatibilite avec les anciennes versions de Java, la 
recherche d'une methode surdefinie a ete adaptee par le JKD5.0 de la maniere suivante : 

• on effectue tout d'abord une recherche, sans tenir compte des methodes a ellipse. Si une seu- 
le methode est trouvee, elle est choisie ; si plusieurs conviennent, il y a toujours erreur ; 
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• si la recherche precedente n'a pas abouti (et seulement dans ce cas la), on effectue une nou- 
velle recherche en faisant intervenir les methodes a ellipse en plus des autres. 

Autrement dit, avec le JDK 5.0, on continuera d'appeler la methode qui l'etait auparavant, 
meme si des methodes a ellipse ont ete ajoutees. 

Voici un exemple assez naturel : 

static void f (int n, int p) { } 

static void f (int... vi) { } 



int il, i2, i3 ; 

f(il, i2) ; // appel de f(int, int) 

f(il) ; // appel de f(int...) 

f(il, i2, i3) ; // appel de f(int...) 

En voici un autre un peu deroutant : 

static void f (int... vi) { } 

static void f (double vl, double v2) { } 



int il, 12 ; 

f(il, i2) ; // appel de f (double, double) 

La recherche sans ellipse conduit au choix de /(double, double). On pourrait penser que 
f(int. ..) est plus appropriee ici ; toutefois, on n'oubliera pas que, independamment des metho- 
des a ellipse, il n'est pas possible de definir a la fois/f/nf, int) et /(double, double) sans qu'un 
appel tel que /(il, 12) conduise a une ambiguite. 



8 

L heritage 



Comme nous Favons deja signale au chapitre 1, le concept d'heritage constitue Fun des fon- 
dements de la programmation orientee objet. II est notamment a l'origine des possibilites de 
reutilisation des composants logiciels que sont les classes. En effet, il permet de definir une 
nouvelle classe, dite classe derivee, a partir d'une classe existante dite classe de base. Cette 
nouvelle classe herite d'emblee des fonctionnalites de la classe de base (champs et methodes) 
qu'elle pourra modifier ou completer a volonte, sans qu'il soit necessaire de remettre en 
question la classe de base. 

Cette technique permet done de developper de nouveaux outils en se fondant sur un certain 
acquis, ce qui justifie le terme d'heritage. Comme on peut s'y attendre, il sera possible de 
developper a partir d'une classe de base, autant de classes derivees qu'on le desire. De me me, 
une classe derivee pourra a son tour servir de classe de base pour une nouvelle classe derivee. 

Comme on le verra au chapitre 12, l'heritage constitue en outre l'un des pilliers de la pro- 
grammation evenementielle. En effet, la moindre application necessitera de creer des classes 
derivees des classes de la bibliotheque standard, en particulier de celles appartenant aux 
paquetages standard java.awt, java.awt.event, javax.swing. 

Nous commencerons par vous presenter la notion d'heritage et sa mise en ceuvre en Java. 
Nous verrons alors ce que deviennent les droits d'acces aux champs et methodes d'une classe 
derivee. Puis nous ferons le point sur la construction et F initialisation des objets derives. 
Nous montrerons ensuite comment une classe derivee peut redefinir une methode d'une 
classe de base et nous preciserons les interferences existant entre cette notion et celle de sur- 
definition. 

Puis nous presenterons la notion la plus fondamentale de Java, le polymorphisme, et nous 
exposerons ses regies. Apres avoir montre que toute classe derive d'une "super-classe" nom- 
inee Object, nous definirons ce qu'est une classe abstraite et Finteret qu'elle peut presenter. 
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Nous examinerons ensuite ce que Ton nomme les "classes enveloppes" qui permettent 
d'encapsuler dans une classe des valeurs d'un type primitif ; nous verrons comment les possi- 
bility dites A' auto boxing, introduites par le JDK 5.0, facilitent les conversions entre ces 
classes et les types primitifs. 

Nous traiterons ensuite des interfaces dont nous verrons qu'elles remplacent avantageuse- 
ment l'heritage multiple de certains langages et qu'elle facilitent la tache de realisation des 
classes en imposant le respect d'un certain contrat. 

Enfin, apres quelques conseils relatifs a la conception generale des classes, nous verrons ce 
que sont les "classes anonymes. 

1 La notion d'heritage 

Nous allons voir comment mettre en ceuvre l'heritage en Java, a partir d'un exemple simple 
de classe ne comportant pas encore de constructeur. Supposez que nous disposions de la 
classe Point suivante (pour l'instant, peu importe qu'elle ait ete declaree publique ou non) : 

class Point 
{ 

public void initialise (int abs, int ord) 

{ x = abs ; y = ord ; 

} 

public void deplace (int dx, int dy) 
{ x += dx ; y += dy ; 

} 

public void affiche () 

{ System. out .println ("Je suis en " + x + " " + y) ; 

} 

private int x, y ; 

} 

Une classe de base Point 

Imaginons que nous ayons besoin d'une classe Pointcol, destinee a manipuler des points 
colores d'un plan. Une telle classe peut manifestement disposer des memes fonctionnalites 
que la classe Point, auxquelles on pourrait adjoindre, par exemple, une methode nommee 
colore, chargee de definir la couleur. Dans ces conditions, nous pouvons chercher a definir la 
classe Pointcol comme derivee de la classe Point. Si nous prevoyons, outre la methode 
colore, un membre nomme couleur, de type byte, destine a representer la couleur d'un point, 
voici comment pourrait se presenter la definition de la classe Pointcol (ici encore, peu 
importe qu'elle soit publique ou non) : 
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class Pointcol extends Point // Pointcol derive de Point 
{ public void colore (byte couleur) 

{ this. couleur = couleur ; 

} 

private byte couleur ; 

} 

Une classe Poincol, derivee de Point 

La mention extends Point precise au compilateur que la classe Pointcol est une classe derivee 
de Point. 

Disposant de cette classe, nous pouvons declarer des variables de type Pointcol et creer des 
objets de ce type de maniere usuelle, par exemple : 

Pointcol pc ; // pc contiendra une reference a un objet de type Pointcol 
Pointcol pc2 = new Pointcol () ; // pc2 contient la reference a un objet de 

// type Pointcol cree en utilisant le pseudo-constructeur par defaut 
pc = new Pointcol ( ) ; 

Un objet de type Pointcol peut alors faire appel : 

• aux methodes publiques de Pointcol, ici colore ; 

• mais aussi aux methodes publiques de Point : initialise, deplace et affiche. 

D'une maniere generate, un objet d'une classe derivee accede aux membres publics de sa 
classe de base, exactement comme s'ils etaient definis dans la classe derivee elle-meme. 

Voici un petit programme complet illustrant ces possibilites (pour l'instant, la classe Pointcol 
est tres rudimentaire ; nous verrons plus loin comment la doter d'autres fonctionnalites indis- 
pensables). Ici, nous creons a la fois un objet de type Pointcol et un objet de type Point. 

// classe de base 
class Point 

{ public void initialise (int abs, int ord) 
{ x = abs ; y = ord ; } 
public void deplace (int dx, int dy) 
{ x += dx ; y += dy ; } 
public void affiche () 

{ System. out. println ("Je suis en " + x + " " + y) ; } 
private int x, y ; 

} 

// classe derivee de Point 
class Pointcol extends Point 
{ public void colore (byte couleur) 

{ this. couleur = couleur ; 

} 

private byte couleur ; 

} 




L'heritage 



Chapitre 8 



II classe utilisant Pointcol 
public class TstPcoll 

{ public static void main (String args[ ] ) 
{ Pointcol pc = new Pointcol ( ) ; 
pc.affiche () ; 
pc. initialise (3, 5) ; 
pc. colore ((byte) 3) ; 
pc.affiche () ; 
pc.deplace (2, -1) ; 
pc.affiche () ; 

Point p = new Point () ; p. initialise (6, 9) ; 
p.affiche() ; 

} 

} 

Je suis en 0 0 
Je suis en 3 5 
Je suis en 5 4 
Je suis en 6 9 

Exemple de creation et a" utilisation d'une classe Pointcol derivee de Point 



1 Une classe de base peut aussi se nommer une super-classe ou tout simplement une classe. 
De meme, une classe derivee peut aussi se nommer une sous-classe. Enfin, on peut parler 
d'heritage ou de derivation, ou encore de sous-classement. 

2 Ici, nous avons regroupe au sein d'un unique fichier source la classe Point, la classe 
Pointcol et une classe contenant la methode main. Nous n' avons done pas pu declarer 
publiques les classes Point et Pointcol. En pratique, il en ira rarement ainsi : au mini- 
mum, la classe Point appartiendra a un fichier different. Mais cela ne change rien aux 
principes de l'heritage ; seuls n'interviendront que des questions de droits d'acces aux 
classes publiques, lesquels, rappelons-le, ne se manifestent de toute facon que si toutes 
les classes n'appartiennent pas au meme paquetage. 

3 Les principes de mise en ceuvre d'un programme comportant plusieurs classes reparties 
dans differents fichiers source s'appliquent encore en cas de classes derivees. Bien 
entendu, pour compiler une classe derivee, il est necessaire que sa classe de base 
appartienne au meme fichier ou qu'elle ait deja ete compilee. 
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2 Acces d'une classe derivee aux membres 
de sa classe de base 

En introduction, nous avons dit qu'une classe derivee herite des champs et methodes de sa 
classe de base. Mais nous n'avons pas precise l'usage qu'elle peut en faire. Voyons precise- 
ment ce qu'il en est en distinguant les membres prives des membres publics. 

2.1 Une classe derivee n'accede pas aux membres prives 

Dans l'exemple precedent, nous avons vu comment les membres publics de la classe de base 
restent des membres publics de la classe derivee. C'est ainsi que nous avons pu appliquer la 
methode intialise a un objet de type Pointcol. 

En revanche, nous n'avons rien dit de la facon dont une methode de la classe derivee peut 
acceder aux membres de la classe de base. En fait, une classe derivee n'a pas plus de droits 
d'acces a sa classe de base que n'importe quelle autre classe 1 : 



Une methode d'une classe derivee n'a pas acces aux membres prives 
de sa classe de base. 



Cette regie peut paraitre restrictive. Mais en son absence, il suffirait de creer une classe deri- 
vee pour violer le principe d' encapsulation. 

Si Ton considere la classe Pointcol precedente, elle ne dispose pour l'instant que d'une 
methode affiche, heritee de Point qui, bien entendu, ne fournit pas la couleur. On peut cher- 
cher a la doter d'une nouvelle methode nommee par exemple affichec, fournissant a la fois les 
coordonnees du point colore et sa couleur. II ne sera pas possible de proceder ainsi : 

void affichecO // methode affichant les coordonnees et la couleur 
{ System. out. println ("Je suis en " + x + " " + y) ; // NON : x et y sont prives 
System. out. println (" et ma couleur est : " + couleur) ; 

} 

En effet, la methode affichec de Pointcol n'a pas acces aux champs prives x et y de sa classe 
de base. 

2.2 Elle accede aux membres publics 

Comme on peut s'y attendre 2 : 



1 . Certains disent alors que la classe derivee n'herite pas des methodes privees de sa classe de base. Mais cette termi- 
nologie nous semble ambigue ; en effet, elle pourrait laisser entendre que ces membres n'appartiennent plus a la clas- 
se derivee, alors qu'ils sont toujours presents (et accessibles par des methodes publiques de la classe de base...). 

2. Attention : ne confondez pas Faeces d'un objet a ses membres avec l'acces d'une classe (e'est-a-dire des ses 
methodes) a ses membres (ou a ceux de sa classe de base), meme si, ici, les droits sont identiques. 
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Une methode d'une classe derivee a acces aux membres publics de sa 
classe de base. 



Ainsi, pour ecrire la methode affichec, nous pouvons nous appuyer sur la methode affiche de 
Point en procedant ainsi : 



public void affichec () 




{ affiche () ; 




System. out .println (" et ma couleur est : 

} 


" + couleur) ; 



Une methode d'affichage d'un objet de type Pointcol 



On notera que l'appel affichef) dans la methode affichec est en fait equivalent a : 

this.afficheO ; 

Autrement dit, il applique la methode affiche a F objet (de type Pointcol) ayant appele la 
methode affichec. 

Nous pouvons proceder de meme pour definir dans Pointcol une nouvelle methode d' initialisation 
nommee initialisec, chargee d'attribuer les coordonnees et la couleur a un point colore : 

public void initialisec (int x, int y, byte couleur) 
{ initialise (x, y) ; 

this. couleur = couleur ; 

} 

Une methode d' initialisation d'un objet de type Pointcol 

2.3 Exemple de programme complet 

Voici un exemple complet de programme reprenant cette nouvelle definition de la classe 
Pointcol et un exemple d' utilisation : 

class Point 

{ public void initialise (int abs, int ord) 
{ x = abs ; y = ord ; } 
public void deplace (int dx, int dy) 
{ x += dx ; y += dy ; } 
public void affiche () 

{ System. out .println ("Je suis en " + x + " " + y) ; 

} 

private int x, y ; 

) 
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class Pointcol extends Point 

{ public void colore (b£yte couleur) 

{ this . couleur = couleur ; 

} 

public void affichec () 
{ afficheO ; 

System. out. println (" et ma couleur est : " + couleur) ; 

} 

public void initialisec (int x, int y, byte couleur) 
{ initialise (x, y) ; 

this . couleur = couleur ; 

} 

private byte couleur ; 

} 

public class TstPcol2 

{ public static void main (String args[ ] ) 
{ Pointcol pel = new Pointcol () ; 
pel . initialise (3, 5) ; 
pel. colore ((byte) 3) ; 

pel . af f iche () ; // attention, ici affiche 
pel . affichec () ; // et ici affichec 
Pointcol pc2 = new Pointcol ( ) ; 
pc2 . initialisec (5, 8, (byte) 2) ; 
pc2.affichec() ; 
pc2.deplace (1, -3) ; 
pc2.affichec() ; 

} 

} 



Je suis en 3 5 
Je suis en 3 5 

et ma couleur est 
Je suis en 5 8 

et ma couleur est 
Je suis en 6 5 

et ma couleur est 



Une nouvelle classe Pointcol et son utilisation 



\^^~ Remarque 

A propos des classes, il nous est arrive de commettre un abus de langage qui consiste a 
parler : 

- d'acces depuis l'exterieur d'une classe pour parler de Faeces d'un objet de la classe a 
ses membres, 
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- d'acces depuis Finterieur d'une classe (ou meme simplement d'acces d'une classe) 
pour parler de Faeces des methodes de la classe a ses membres. 

De meme, il nous arrivera de parler de Faeces d'une classe derivee aux membres de sa 
classe de base sans preciser qu'il s'agit de Faeces de ses methodes. 

Notons d'emblee que dans une classe derivee : 

- les membres publics de sa classe de base se comportent comme des membres publics 
de la classe derivee, 

- les membres prives de la classe de base se comportent comme des membres prives de- 
puis l'exterieur de la classe derivee ; en revanche, comme ils ne sont pas accessibles a 
la classe derivee, on ne peut pas dire qu'ils se comportent comme de propres membres 
prives de la classe derivee. 



L'heritage existe, mais il comporte plus de possibilites qu'en Java. Tout d'abord, lors de la 
definition d'une classe derivee, on peut restreindre ses droits d'acces aux membres de sa 
classe de base (on dispose finalement de trois sortes de derivation : publique, privee ou 
protegee). Par ailleurs, contrairement a Java, C++ permet l'heritage multiple. 



Dans les exemples precedents, nous avons volontairement choisi des classes sans construe - 
teurs. En pratique, la plupart des classes en disposeront. Nous allons examiner ici les diffe- 
rentes situations possibles (presence ou absence de constructeur dans la classe de base et dans 
la classe derivee). Puis nous preciserons, comme nous F avons fait pour les classes simples 
(non derivees), la chronologie des differentes operations d'initialisation (implicites ou expli- 
cites) et d'appel des constructeurs. 



Rappelons que dans le cas d'une classe simple (non derivee), la creation d'un objet par new 
entraine l'appel d'un constructeur ayant la signature voulue 1 (nombre et type des arguments). 
Si aucun constructeur ne convient, on obtient une erreur de compilation sauf si la classe ne 
dispose d' aucun constructeur et que l'appel de new s'est fait sans argument. On a affaire alors 
a un pseudo-constructeur par defaut (qui ne fait rien). Voyons ce que deviennent ces regies 
avec une classe derivee. 



3 Construction et initialisation 
des objets derives 



3.1 Appels des constructeurs 



1. Moyennant d'eventuelles conversions legales. 
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3.1.1 Exemple introductif 

Examinons d'abord un exemple simple dans lequel la classe de base (Point) et la classe deri- 
vee (Pointcol) disposent toutes les deux d'un constructeur (ce qui correspond a la situation la 
plus courante en pratique). 

Pour fixer les idees, supposons que nous utilisions le schema suivant, dans lequel la classe 
Point dispose d'un constructeur a deux arguments et la classe Pointcol d'un constructeur a 
trois arguments : 

class Point 
{ 

public Point (int x, int y) 

{ 

} 

private int x, y ; 

} 

class Pointcol extends Point 
{ 

public Pointcol (int x, int y, byte couleur) 

{ 

} 

private byte couleur ; 

} 

Tout d'abord, il faut savoir que : 



En Java, le constructeur de la classe derivee doit prendre en charge 
I'integralite de la construction de I'objet. 

S'il est necessaire d'initialiser certains champs de la classe de base et qu'ils sont convenable- 
ment encapsules, il faudra disposer de fonctions d' alteration ou bien recourir a un construc- 
teur de la classe de base. 

Ainsi, le constructeur de Pointcol pourrait : 

• initialiser le champ couleur (accessible, car membre de Pointcol), 

• appeler le constructeur de Point pour initialiser les champs x et y. 

Pour ce faire, il est toutefois imperatif de respecter une regie imposee par Java : 



Si un constructeur d'une classe derivee appelle un constructeur d'une 
classe de base, il doit obligatoirement s'agir de la premiere instruction du 
constructeur et ce dernier est designe par le mot-cle super. 

Dans notre cas, voici ce que pourrait etre cette instruction : 

super (x, y) ; // appel d' un constructeur de la classe de base, auquel 
// on fournit en arguments les valeurs de x et de y 

D'oii notre constructeur de Pointcol : 
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public Pointcol (int x, int y, byte couleur) 

{ super (x, y) ; // obligatoirement comme premiere instruction 

this. couleur = couleur ; 

} 

Voici un petit programme complet illustrant cette possibilite. II s'agit d'une adaptation du 
programme du paragraphe 2.3, dans lequel nous avons remplace les methodes d' initialisation 
des classes Point et Pointcol par des constructeurs. 



class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 

} 

public void deplace (int dx, int dy) 
{ x += dx ; y += dy ; 

} 



public void affiche () 
{ System. out .println ("Je suis en " + x + " " + y) ; 

} 

private int x, y ; 



class Pointcol extends Point 

{ public Pointcol (int x, int y, byte couleur) 

{ super (x, y) ; // obligatoirement comme premiere instruction 

this. couleur = couleur ; 

} 

public void affichec () 
{ affiche () ; 

System. out .println (" et ma couleur est : " + couleur) ; 

} 

private byte couleur ; 



public class TstPcol3 

{ public static void main (String args[ ] ) 

{ Pointcol pel = new Pointcol (3, 5, (byte) 3) ; 
pcl.afficheO ; // attention, ici affiche 
pel. affichec () ; // et ici affichec 



Pointcol pc2 = new Pointcol (5, 8, (byte) 2) ; 
pc2 . affichec ( ) ; 
pc2. deplace (1, -3) ; 
pc2. affichec () ; 




Je suis en 3 5 
Je suis en 3 5 

et ma couleur est : 3 
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Je suis en 5 8 

et ma couleur est : 2 
Je suis en 6 5 

et ma couleur est : 2 

Appel du constructeur d'une classe de base dans un constructeur d'une classe derivee 



1 Nous avons deja signale qu'il est possible d'appeler dans un constructeur un autre cons- 
tructeur de la meme classe, en utilisant le mot-cle this comme nom de methode. Comme 
celui effectue par super, cet appel doit correspondre a la premiere instruction du construc- 
teur. Dans ces conditions, on voit qu'il n'est pas possible d'exploiter les deux possibilites 
en meme temps. 

2 Nous montrerons plus loin qu'une classe peut deliver d'une classe qui derive elle- 
meme d'une autre. L'appel par super ne concerne que le constructeur de la classe de 
base du niveau immediatement superieur. 

3 Le mot-cle super possede d'autres utilisations que nous examinerons au paragraphe 6.8. 



C++ dispose d'un mecanisme permettant d'expliciter directement l'appel d'un construc- 
teur d'une classe de base dans l'en-tete meme du constructeur de la classe derivee. 

3.1 .2 Cas general 

L'exemple precedent correspond a la situation la plus usuelle, dans laquelle la classe de base 
et la classe derivee disposent toutes les deux d'au moins un constructeur public (les construc- 
teurs peuvent etre surdefinis sans qu'aucun probleme particulier ne se pose). Dans ce cas, 
nous avons vu que le constructeur concerne de la classe derivee doit prendre en charge l'inte- 
gralite de l'objet derive, quitte a s'appuyer sur un appel explicite du constructeur de la classe 
de base. Examinons les autres cas possibles, en distinguant deux situations : 

• la classe de base ne possede aucun constructeur, 

• la classe derivee ne possede aucun constructeur. 

La classe de base ne possede aucun constructeur 

II reste possible d'appeler le constructeur par defaut dans la classe derivee, comme dans : 

class A 




Remarques 



En C++ 



// aucun constructeur 
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class B extends A 

{ public B (...) // constructeur de B 

{ super () ; // appelle ici le pseudo-constructeur par defaut de A 

} 

} 

L'appel superf) est ici superflu, mais il ne nuit pas. En fait, cette possibilite s'avere pratique 
lorsque Ton definit une classe derivee sans connaitre les details de la classe de base. On peut 
ainsi s' assurer qu'un constructeur sans argument de la classe de base sera toujours appele et, 
si cette derniere est bien concue, que la partie de B heritee de A sera done convenablement 
initialisee. 

Bien entendu, il reste permis de ne doter la classe B d'aucun constructeur. Nous verrons qu'il 
y aura alors appel d'un constructeur par defaut de A ; comme ce dernier ne fait rien, au bout 
du compte, il ne se passera rien de particulier ! 

La classe derivee ne possede aucun constructeur 

Si la classe derivee ne possede pas de constructeur, il n'est bien sur plus question de prevoir 
un appel explicite (par super) d'un quelconque constructeur de la classe de base. On sait deja 
que, dans ce cas, tout se passe comme s'il y avait appel d'un constructeur par defaut sans 
argument. Dans le cas d'une classe simple, ce constructeur par defaut ne faisait rien (nous 
l'avons d'ailleurs qualifie de "pseudo-constructeur"). Dans le cas d'une classe derivee, il est 
prevu qu'il appelle un constructeur sans argument de la classe de base. On va retrouver ici les 
regies correspondant a la creation d'un objet sans argument, ce qui signifie que la classe de 
base devra : 

• soit posseder un constructeur public sans argument, lequel sera alors appele, 

• soit ne posseder aucun constructeur ; il y aura appel du pseudo-constructeur par defaut. 
Voici quelques exemples. 

Exemple 1 

class A 

{ public A() { } // constructeur 1 de A 

public A (int n) { } // constructeur 2 de A 

} 

class B extends A 

{ // pas de constructeur 

} 

B b = new B() ; // construction de B — > appel de constructeur 1 de A 

La construction d'un objet de type B entraine l'appel du constructeur sans argument de A. 

Exemple 2 

class A 

{ public A (int n) { } // constructeur 2 seulement 

) 
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class B extends A 

{ // pas de constructeur 

} 

Ici, on obtient une erreur de compilation car le constructeur par defaut de B cherche a appeler 
un constructeur sans argument de A. Comme cette derniere dispose d'au moins un construc- 
teur, il n'est plus question d'utiliser le constructeur par defaut de A. 

Exemple 3 

class A 

{ // pas de constructeur 

} 

class B extends A 

{ // pas de constructeur 

} 

Cet exemple ressemble au precedent, avec cette difference que A ne possede plus de cons- 
tructeur. Aucun probleme ne se pose plus. La creation d'un objet de type B entraine l'appel 
du constructeur par defaut de B, qui appelle le constructeur par defaut de A. 

3.2 Initialisation d'un objet derive 

Jusqu'ici, nous n'avons considere que les constructeurs impliques dans la creation d'un objet 
derive. Mais comme nous l'avons deja signale au paragraphe 2.4 du chapitre 6 pour les clas- 
ses simples, la creation d'un objet fait intervenir plusieurs phases : 

• allocation memoire, 

• initialisation par defaut des champs, 

• initialisation explicite des champs, 

• execution des instructions du constructeur. 

La generalisation a un objet d'une classe derivee est assez intuitive. Supposons que : 

class B extends A { } 

La creation d'un objet de type B se deroule en 6 etapes. 

1. Allocation memoire pour un objet de type B ; il s'agit bien de l'integralite de la memoire 
necessaire pour un tel objet, et pas seulement pour les champs propres a B (c'est-a-dire non 
herites de A). 

2. Initialisation par defaut de tous les champs de B (aussi bien ceux herites de A, que ceux 
propres a B) aux valeurs "nulles" habituelles. 

3. Initialisation explicite, s'il y a lieu, des champs herites de A ; eventuellement, execution 
des blocs d'initialisation de A. 

4. Execution du corps du constructeur de A. 

5. Initialisation explicite, s'il y a lieu, des champs propres a B ; eventuellement, execution des 
blocs d'initialisation de B. 

6. Execution du corps du constructeur de B. 
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Comme il a deja ete dit pour les classes simples (voir paragraphe 2.4.3 du chapitre 6), on aura 
interet en pratique a s'arranger pour que l'utilisateur de la classe n'ait pas besoin de s'inter- 
roger sur Fordre chronologique exact de ces differentes operations. 

Remarque 

Le constructeur a appeler dans la classe de base est souvent defini par la premiere instruc- 
tion superf...) d'un constructeur de la classe derivee. Cela pourrait laisser croire que P ini- 
tialisation explicite de la classe derivee est faite avant l'appel du constructeur de la classe 
de base, ce qui n'est pas le cas. C'est d'ailleurs probablement pour cette raison que Java 
impose que cette instruction superf...) soit la premiere du constructeur : le compilateur est 
bien en mesure alors de definir le constructeur a appeler. 

4 Derivations successives 

Jusqu'ici, nous n'avons raisonne que sur deux classes a la fois et nous parlions generalement 
de classe de base et de classe derivee. En fait, comme on peut s'y attendre : 

• d'une meme classe peuvent etre derivees plusieurs classes differentes, 

• les notions de classe de base et de classe derivee sont relatives puisqu'une classe derivee 
peut, a son tour, servir de classe de base pour une autre. 

Autrement dit, on peut tres bien rencontrer des situations telles que celle representee par 
l'arborescence suivante 1 : 




D est derivee de B, elle-meme derivee de A. On dit souvent que D derive de A. On dit aussi 
que D est une sous-classe de A ou que A est une super-classe de D. Parfois, on dit que D est 



1. Ici, les fleches vont de la classe de base vers la classe derivee. On peut rencontrer la situation inverse. 
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une descendante de A ou encore que A est une ascendante de D. Naturellement, D est aussi 
une descendante de B. Lorsqu'on a besoin d'etre plus precis, on dit alors que D est une des- 
cendante directe de B. 

TSjh En C++ 

Contrairement a Java, C++ dispose de l'heritage multiple, notion generalement delicate a 
manipuler en conception orientee objet. Nous verrons que Java dispose en revanche de la 
notion d'interface, qui offre des possibilites proches de celles de l'heritage multiple, sans 
en presenter les inconvenients. 

5 Redefinition et surdefinition de membres 

5.1 Introduction 

Nous avons deja etudie la notion de surdefinition de methode a l'interieur d'une meme classe. 
Nous avons vu qu'elle correspondait a des methodes de meme nom, mais de signatures diffe- 
rentes. Nous montrerons ici comment cette notion se generalise dans le cadre de l'heritage : 
une classe derivee pourra a son tour surdefinir une methode d'une classe ascendante. Bien 
entendu, la ou les nouvelles methodes ne deviendront utilisables que par la classe derivee ou 
ses descendantes, mais pas par ses ascendantes. 

Mais auparavant, nous vous presenterons la notion fondamentale de redefinition d'une 
methode. Une classe derivee peut en effet fournir une nouvelle definition d'une methode 
d'une classe ascendante. Cette fois, il s'agira non seulement de methodes de meme nom 
(comme pour la surdefinition), mais aussi de meme signature et de meme type de valeur de 
retour. Alors que la surdefinition permet de cumuler plusieurs methodes de meme nom, la 
redefinition substitue une methode a une autre. 

Compte tenu de son importance, en particulier au niveau de ce que Ton nomme le polymor- 
phisme, nous vous presenterons d'abord cette notion de redefinition independamment des 
possibilites de surdefinition. Nous verrons ensuite comment surdefinition et redefinition peu- 
vent intervenir conjointement et nous vous livrerons les regies generates correspondantes. 

5.2 La notion de redefinition de methode 

Nous avons vu qu'un objet d'une classe derivee peut acceder a toutes les methodes publiques 
de sa classe de base. Considerons : 

class Point 

{ 

public void af f iche ( ) 

{ System. out. println ("Je suis en " + x + " " + y) ; 
} 

private int x, y ; 

) 
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class Pointcol extends Point 

{ // ici, on suppose qu' aucune methode ne se nonme affiche 

private byte couleur ; 

} 

Point p ; Pointcol pc ; 

L'appel p.affichef) fournit tout naturellement les coordonnees de l'objet p de type Point. 
L'appel pc.affiche() fournit egalement les coordonnees de l'objet pc de type Pointcol, mais 
bien entendu, il n'a aucune raison d'en fournir la couleur. 

C'est la raison pour laquelle, dans Fexemple du paragraphe 2.3, nous avions introduit dans la 
classe Pointcol une methode affichec affichant a la fois les coordonnees et la couleur d'un 
objet de type Pointcol. 

Or, manifestement, ces deux methodes affiche et affichec font un travail semblable : elles affi- 
chent les valeurs des donnees d'un objet de leur classe. Dans ces conditions, il parait logique 
de chercher a leur attribuer le meme nom. 

Cette possibilite existe en Java ; elle se nomme redefinition de methode. Elle permet a une 
classe derivee de redefinir une methode de sa classe de base, en en proposant une nouvelle 
definition. Encore faut-il respecter la signature de la methode (type des arguments), ainsi que 
le type de la valeur de retour 1 . C'est alors cette nouvelle methode qui sera appelee sur tout 
objet de la classe derivee, masquant en quelque sorte la methode de la classe de base. 

Nous pouvons done definir dans Pointcol une methode affiche reprenant la definition actuelle 
de affichec. Si les coordonnees de la classe Point sont encapsulees et si cette derniere ne dis- 
pose pas de methodes d'acces, nous devrons utiliser dans cette methode affiche de Pointcol la 
methode affiche de Point. Dans ce cas, un petit probleme se pose ; en effet, nous pourrions 
etre tentes d'ecrire ainsi notre nouvelle methode (en changeant simplement l'en-tete affichec 
en affiche) : 

class Pointol extends Point 
{ public void affiche () 
{ affiche () ; 

System. out. println (" et ma couleur est " + couleur) ; 

} 



Or, l'appel affichef) provoquerait un appel recursif de la methode affiche de Pointcol. II faut 
done preciser qu'on souhaite appeler non pas la methode affiche de la classe Pointcol, mais la 
methode affiche de sa classe de base. II suffit pour cela d' utiliser le mot-cle super, de cette 
facon : 



1. Si la signature n'est pas respectee, on a affaire a une surdefinition ; nous y reviendrons un peu plus loin. Le 
respect du type de la valeur de retour semble moins justifie ; on verra que Java l'impose pour faciliter ['utilisa- 
tion du polymorphisme ; depuis le JDK 5.0JDK 5.0, cette contrainte s'assouplit quelque peu grace a la notion 
de "valeur de retour covariante" que nous examinerons au paragraphe 5.7.2 
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public void af f iche ( ) 

{ super . aff iche ( ) ; // appel de la methode affiche de la super-classe 

System. out. println (" et ma couleur est " + couleur) ; 

} 

Dans ces conditions, l'appel pc.affiche() entrainera bien l'appel de affiche de Pointcol, 
laquelle, comme nous l'esperons, appellera affiche de Point, avant d'afficher la couleur. 

Voici un exemple complet de programme illustrant cette possibility : 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 
} 

public void deplace (int dx, int dy) 
{ x += dx ; y += dy ; } 
public void affiche () 

{ System. out. println ("Je suis en " + x + " " + y) ; 
} 

private int x, y ; 

} 

class Pointed extends Point 

{ public Pointcol (int x, int y, byte couleur) 

{ super (x, y) ; // obligatoirement comme premiere instruction 

this. couleur = couleur ; 

} 

public void affiche () 
{ super. affiche () ; 

System. out. println (" et ma couleur est : " + couleur) ; 

} 

private byte couleur ; 

) 

public class TstPcol4 

{ public static void main (String args[ ] ) 

{ Pointcol pc = new Pointcol (3, 5, (byte) 3) ; 

pc. aff iche () ; // ici, il s' agit de affiche de Pointcol 
pc. deplace (1, -3) ; 
pc . affiche ( ) ; 

} 

} 

Je suis en 3 5 

et ma couleur est : 3 
Je suis en 4 2 

et ma couleur est : 3 



Exemple de redefinition de la methode affiche dans une classe derivee Pointcol 
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Remarque 

Meme si cela est frequent, une redefinition de methode n'entraine pas necessairement 
comme ici l'appel par super de la methode correspondante de la classe de base. 

5.3 Redefinition de methode et derivations successives 

Comme nous Favons dit au paragraphe 4, on peut rencontrer des arborescences d' heritage 
aussi complexes qu'on le veut. Comme on peut s'y attendre, la redefinition d'une methode 
s'applique a une classe et a toutes ses descendantes jusqu'a ce qu'eventuellement l'une 
d'entre elles redefinisse a nouveau la methode. Considerons par exemple l'arborescence sui- 
vante, dans laquelle la presence d'un asterisque (*) signale la definition ou la redefinition 
d'une methode /: 



A* 




Dans ces conditions, l'appel de la methode / conduira, pour chaque classe, a l'appel de la 
methode indiquee en regard : 

classe A : methode fdeA, 

classe B : methode fdeA, 

classe C : methode /de C, 

classe D : methode /de D, 

classe E : methode /de A, 

classe F : methode /de C. 



5.4 Surdefinition et heritage 

Jusqu'a maintenant, nous n'avions considere la surdefinition qu'au sein d'une meme classe. 
En Java, une classe derivee peut surdefinir une methode d'une classe de base (ou, plus gene- 
ralement, d'une classe ascendante). En voici un exemple : 
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class A 

{ public void f (int n) { } 



) 

class B extends A 

{ public void f (float x) { } 



} 

A a ; B b ; 

int n ; float x ; 



a.f (n) ; // appelle f (int) de A 

a. f(x) ; // erreur de compilation : une seule methode acceptable (f(int) de A 

// et on ne peut pas convertir x de float en int 

b. f (n) ; // appelle f (int) de A 
b.f(x) ; // appelle f (float) de B 

Bien entendu, la encore, la recherche d'une methode acceptable ne se fait qu'en remontant la 
hierarchie d'heritage, jamais en la descendant... C'est pourquoi l'appel a.f(x) ne peut etre 
satisfait, malgre la presence dans B d'une fonction/qui conviendrait. 

£Jf En C++ 

La surdefinition ne "franchit pas l'heritage". On considere un seul ensemble de methodes 
d'une classe donnee (la premiere qui, en remontant la hierarchie, possede au moins une 
methode ay ant le nom voulu). 

5.5 Utilisation simultanee de surdefinition et de redefinition 

Surdefinition et redefinition peuvent cohabiter. Voyez cet exemple : 

class A 
{ 

public void f (int n) { } 

public void f (float x) { } 

> 

class B extends A 
{ 

public void f (int n) { } // redefinition de f (int) de A 

public void f (double y) { } // surdefinition de f (de A et de B) 

> 

A a ; B b ; 

int n ; float x ; double y ; 



a 


f(n) ; 


// appel de f(int) de 


A 


(mise 


en 


jeu 


de 


surdefinition dans A) 


a 


f(x) ; 


// appel de f (float) de 


A 


(mise 


en 


jeu 


de 


surdefinition dans A) 


a 


f(y) ; 


// erreur de compilation 














b 


f(n) ; 


// appel de f(int) de 


B 


(mise 


en 


jeu 


de 


redefinition) 


b 


f(x) ; 


// appel de f (float) de 


A 


(mise 


en 


jeu 


de 


surdefinition dans A et B) 


b 


f(y) ; 


// appel de f (double) de 


B 


(mise 


en 


jeu 


de 


surdefinition dans A et B) 
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Remarque 

La richesse des possibilites de cohabitation entre surdefinition et redefinition peut con- 
duire a des situations complexes qu'il est generalement preferable d'eviter en soignant la 
conception des classes. 



5.6 Cas particulier des methodes a ellipse (JDK 5.0) 

Nous avons vu que le JDK 5.0 a introduit la possibility d'ellipse dans une liste d'arguments 
d'une methode. Considerons alors cet exemple : 

class A 

{ void f (int il, int 12) { } 

} 

class B extends A 

{ void f (int. . . e) { } 

} 

B b ; int il, i2, i3 ; 



b.f() ; // appel de B.f (int...) 

b.f(il) ; // appel de B.f (int...) 

b.f (il, i2) ; // appel de A.f (int, int) 

b.f(il, i2, i3) ; // appel de B.f (int...) 

Ici, la methode f(int... e) de B n'est pas une redefinition de/de A, puisque les signatures sont 
differentes. II s'agit done d'une surdefinition. Mais, comme nous l'avons deja dit, la recher- 
che d'une methode surdefinie se fait d'abord sans recourir aux methodes a ellipse qui ne sont 
mises en jeu qu'en cas d'echec. D'oii les resultats constates. 

5.7 Contraintes portant sur la redefinition 
5.7.1 Valeur de retour 

Lorsqu'on surdefinit une methode, on n'est pas oblige de respecter le type de la valeur de 
retour. Cet exemple est legal : 

class A 
{ 

public int f (int n) { } 

} 

class B extends A 
{ 

public float f (float x) { } 

} 

En revanche, en cas de redefinition, Java impose non seulement l'identite des signatures, 
mais aussi celle du type de la valeur de retour : 
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class A 

{ public int f (int n) { } 

} 

class B extends A 

{ public float f (int n) { } // erreur 

} 

Ici, on n'a pas affaire a une surdefinition de/puisque la signature de la methode est la meme 
dans A et dans B. II devrait done s'agir d'une redefinition, mais comme les types de retour 
sont differents, on aboutit a une erreur de compilation. 

Remarque 

Dores et deja, on voit que ces regies apportent une certaine homogeneite dans la manipu- 
lation d'objets d'un type de base et d'objets d'un type derive. Les deux types d'objets 
peuvent se voir appliquer une methode donnee de la meme facon syntaxique ; cette 
remarque concerne aussi l'usage qui est fait de la valeur de retour (alors que la methode 
effectivement appelee est differente). Ces regies prendront encore plus d'interet dans le 
contexte du polymorphisme dont nous parlons un peu plus loin. 



5.7.2 Cas particulier des valeurs de retour covariantes (JDK 5.0) 

Nous venons de voir que pour qu'il y ait redefinition de methode, il doit y avoir identite du 
type de la valeur de retour. Le JDK 5.0 introduit une exception a cette regie : la nouvelle 
methode peut maintenant renvoyer une valeur d'un type identique ou derive de celui de la 
methode qu'elle redefinit. En pratique, ceci est surtout utilise pour gerer convenablement des 
situations de ce type : 
class A 

{ public A f () { } 



} 

class B extends A 

{ public B f () { } // B.f redefinit bien A.f 



} 

Ici, /ne possede aucun argument. Dans le cas contraire, il faudrait bien sur qu'ils soient de 
meme type dans les deux classes A et B pour que Ton ait affaire a une redefinition. On voit 
que la methode/: 

• appliquee a un objet de type A fournit un resultat de type A, 

• appliquee a un objet de type B, fournit un resultat de type B. 

Nous verrons que cette possibilite s'avere particulierement interessante dans le contexte du 
"polymorphisme". Cependant, la regie de covariance autorise egalement des situations moins 
naturelles que celle-ci : 
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class X { } 

class Y extends X | } 

class A 

{ public X f () { } 



} 

class B extends A 

{ public Y f () { } // B.f redefinit encore ici A.f 



TSf- En C++ 

En C++, la notion de methode covariante existe egalement. Elle ne concerne cependant 
ques les fonctions "virtuelles" dont les valeurs de retour sont transmises par pointeur ou 
par reference. 



5.7.3 Les droits d'acces 

Considerons cet exemple : 

class A 

{ public void f (int n) { } 

} 

class B extends A 

{ private void f (int n) { } // tentative de redefinition de f de A 

} 

II est rejete par le compilateur. S'il etait accepte, un objet de classe A aurait acces a la 
methode/, alors qu'un objet de classe derivee B n'y aurait plus acces. La classe derivee rom- 
prait en quelque sorte le contrat etabli par la classe A. C'est pourquoi la redefinition d'une 
methode ne doit pas diminuer les droits d'acces a cette methode. En revanche, elle peut 
les augmenter, comme dans cet exemple : 
class A 

{ private void f (int n) { } 

} 

class B extends A 

{ public void f (int n) { } // redefinition de f avec extension 

} / / des droits d' acces 

Ici, on redefinit / dans la classe derivee et, en plus, on la rend accessible a l'exterieur de la 
classe. On pourrait penser qu'on viole ainsi 1' encapsulation des donnees. En fait, il n'en est 
rien puisque la methode /de 8n'a pas acces aux membres prives de A. Simplement, tout se 
passe comme si la classe B etait dotee d'une fonctionnalite supplementaire par rapport a A. 

Rappelons que nous avons rencontre trois sortes de droits d'acces a une classe : public, pri- 
vate et "rien" correspondant a Faeces de paquetage (revoyez eventuellement le paragraphe 
13.4.2 du chapitre 6). Nous verrons un peu plus loin qu'il en existe un quatrieme, protected, 
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d'ailleurs peu utilise. Ces quatre droits d'acces se classent dans cet ordre, du plus eleve au 
moins eleve : 

public absence de mention (droit de paquetage) protected private 

On trouvera a 1' Annexe A un recapitulatif de tout ce qui concerne les differents droits d'acces 
a une classe, un membre, une classe interne ou une interface. 

5.8 Regies generales de redefinition et de surdefinition 

Compte tenu de la complexite de la situation, voici un recapitulatif des regies de surdefinition 
et de redefinition. 



Si une methode d'une classe derivee a la meme signature qu'une 
methode d'une classe ascendante : 

- les valeurs de retour des deux methodes doivent etre exactement de 
meme type (ou, depuis le JDK 5.0, etre covariantes), 

- le droit d'acces de la methode de la classe derivee ne doit pas etre 
moins eleve que celui de la classe ascendante, 

- la clause throws de la methode de la classe derivee ne doit pas men- 
tionner des exceptions non mentionnees dans la clause throws de la 
methode de la classe ascendante (la clause throws sera etudiee au cha- 
pitre 10). 

Si ces trois conditions sont remplies, on a affaire a une redefinition. 
Sinon, il s'agit d'une erreur. 

Dans les autres cas, c'est-a-dire lorsqu'une methode d'une classe derivee a le meme nom 
qu'une methode d'une classe ascendante, avec une signature differente, on a affaire a une 
surdefinition. Cela est vrai, quels que soient les droits d'acces des deux methodes. La nou- 
velle methode devient utilisable par la classe derivee et ses descendantes eventuelles (selon 
ses propres droits d'acces), sans masquer les methodes de meme nom des classes ascendan- 
tes. 

Remarques 

1 Une methode de classe (static) ne peut pas etre redefinie dans une classe derivee. Cette 
restriction va de soi puisque c'est le type de l'objet appelant une methode qui permet de 
choisir entre la methode de la classe de base et celle de la classe derivee. Comme une 
methode de classe peut etre appelee sans etre associee a un objet, on comprend qu'un tel 
choix ne soit plus possible. 

2 Les possibilites de redefinition d'une methode prendront tout leur interet lorsqu'elles 
seront associees au polymorphisme que nous etudions un peu plus loin. 
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5.9 Duplication de champs 

Bien que cela soit d'un usage peu courant, une classe derivee peut definir un champ portant le 
meme nom qu'un champ d'une classe de base ou d'une classe ascendante. Considerons cette 
situation, dans laquelle nous avons exceptionnellement prevu des champs publics : 

class A 

{ public int n ; 



} 

class B extends A 
{ public float n ; 

public void f ( ) 
{ n = 5. 25f ; // n designe le champ n (float) de B 

super. n = 3 ; // tandis que super. n designe le champ n (int) de la super- 
// classe de B 

} 

} 

A a ; B b ; 

a. n = 5 ; // a.n designe ici le champ n(int) de la classe A 

b. n = 3.5f ; // b.n designe ici le champ n(float) de la classe B 

II n'y a done pas redefinition du champ n comme il y a redefinition de methode, mais creation 
d'un nouveau champ qui s'ajoute a l'ancien. Toutefois, alors que les deux champs peuvent 
encore etre utilises depuis la classe derivee, seul le champ de la classe derivee n'est visible de 
l'exterieur. Voici un petit programme complet tres artificiel illustrant la situation : 

class A 

{ public int n= 4 ; } 
class B extends A 
{ public float n = 4.5f ; } 
public class DupChamp 

{ public static void main (String! ] args) 
{ A a = new A() ; B b = new B() ; 

System. out .println ("a.n = " + a.n) ; 
System. out .println ("b.n = " + b.n) ; 

} 

} 

a. n = 4 

b. n = 4.5 



Exemple (artificiel) de duplication de champs 
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Voyons maintenant comment Java permet de mettre en ceuvre ce qu'on nomme generalement 
le polymorphisme. II s'agit d'un concept extremement puissant en P.O.O., qui complete 
1' heritage. On peut caracteriser le polymorphisme en disant qu'il permet de manipuler des 
objets sans en connaitre (tout a fait) le type. Par exemple, on pourra construire un tableau 
d'objets (done en fait de references a des objets), les uns etant de type Point, les autres etant 
de type Pointcol (derive de Point) et appeler la methode affiche pour chacun des objets du 
tableau. Chaque objet reagira en fonction de son propre type. 

Mais il ne s'agira pas de traiter ainsi n'importe quel objet. Nous montrerons que le polymor- 
phisme exploite la relation est induite par l'heritage en appliquant la regie suivante : un point 
colore est aussi un point, on peut done bien le traiter comme un point, la reciproque etant 
bien stir fausse. 



Considerons cette situation dans laquelle les classes Point et Pointcol sont censees disposer 
chacune d'une methode affiche, ainsi que des constructeurs habituels (respectivement a deux 
et trois arguments) : 



6.1 Les bases du polymorphisme 



class Point 



{ public Point (int x, int y) { 
public void affiche () { .... 



class Pointcol extends Point 



{ public Pointcol (int x, int y, byte couleur) 
public void affiche () { } 



Avec ces instructions : 



Point p ; 

p = new Point (3, 5) ; 

on aboutit tout naturellement a cette situation : 



(Point) p 




x 



y 



Mais il se trouve que Java autorise ce genre d' affectation (p etant toujours de type Point) 

p = new Pointcol (4, 8, (byte) 2) ; // p de type Point contient la reference 

// a un objet de type Pointcol 
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La situation correspondante est la suivante : 



(Point) p 




4 



2 



8 



x 



y 



couleur 



D'une maniere generale, Java permet d'affecter a une variable objet non seulement la refe- 
rence a un objet du type correspondant, mais aussi une reference a un objet d'un type derive. 
On peut dire qu'on est en presence d'une conversion implicite (legale) d'une reference a un 
type classe T en une reference a un type ascendant de T ; on parle aussi de compatibilite par 
affectation entre un type classe et un type ascendant. 

Considerons maintenant ces instructions : 

Point p = new Point (3, 5) ; 

p.affiche () ; // appelle la methode affiche de la classe Point 
p = new Poincol (4, 8, 2) ; 

p.affiche () ; // appelle la methode affiche de la classe Pointcol 
Dans la derniere instruction, la variable p est de type Point, alors que l'objet reference par p 
est de type Pointcol. L' instruction p.affiche() appelle alors la methode affiche de la classe 
Pointcol. Autrement dit, elle se fonde, non pas sur le type de la variable p, mais bel et bien 
sur le type effectif de l'objet reference par p au moment de l'appel (ce type pouvant evoluer 
au fil de 1' execution). Ce choix d'une methode au moment de F execution (et non plus de la 
compilation) porte generalement le nom de ligature dynamique (ou encore de liaison dyna- 
mique). 

En resume, le polymorphisme en Java se traduit par : 

• la compatibilite par affectation entre un type classe et un type ascendant, 

• la ligature dynamique des methodes. 

Le polymorphisme permet d'obtenir un comportement adapte a chaque type d' objet, sans 
avoir besoin de tester sa nature de quelque facon que ce soit. La richesse de cette technique 
amene parfois a dire que l'instruction switch est a la P.O.O. ce que l'instruction goto est a la 
programmation structured. Autrement dit, le bon usage de la P.O.O (et du polymorphisme) 
permet parfois d'eviter des instructions de test, de meme que le bon usage de la programma- 
tion structuree permettait d'eviter l'instruction goto. 



En C++, on dispose des memes regies de compatibilite entre un type classe et un type 
ascendant. En revanche, le choix d'une methode est, par defaut, realise a la compilation 
(on parle de ligature statique). Mais il est possible de declarer certaines methodes virtuel- 
les (mot-cle virtual), ce qui a pour effet de les soumettre a une ligature dynamique. En 
Java, tout se passe comme si toutes les methodes etaient virtuelles. 



En C++ 
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Exemple 1 

Voici un premier exemple integrant les situations exposees ci-dessus dans un programme 
complet : 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 
} 

public void deplace (int dx, int dy) 

{ x += dx ; y += dy ; 

} 

public void affiche () 

{ System. out. println ("Je suis en " + x + " " + y) ; 
} 

private int x, y ; 

} 

class Pointed extends Point 

{ public Pointcol (int x, int y, byte couleur) 

{ super (x, y) ; // obligatoirement comme premiere instruction 

this. couleur = couleur ; 

} 

public void affiche () 
{ super . affiche ( ) ; 

System . out . println (" et ma couleur est : " + couleur) ; 

} 

private byte couleur ; 

} 

public class Poly 

{ public static void main (String args[ ] ) 
{ Point p = new Point (3, 5) ; 

p.afficheO ; // appelle affiche de Point 
Pointcol pc = new Pointcol (4, 8, (byte) 2) ; 

p = pc ; // p de type Point, reference un objet de type Pointcol 

p.afficheO ; // on appelle affiche de Pointcol 

p = new Point (5, 7) ; // p reference a nouveau un objet de type Point 
p.afficheO ; //on appelle affiche de Point 

} 

} 

Je suis en 3 5 
Je suis en 4 8 

et ma couleur est : 2 
Je suis en 5 7 



Exemple de polymorphisme 
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Exemple 2 

Voici un second exemple de programme complet dans lequel nous exploitons les possibilites 
de polymorphisme pour creer un tableau "heterogene" d'objets, c'est-a-dire dans lequel les 
elements peuvent etre de type different. 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 

} 

public void affiche () 

{ System. out .println ("Je suis en " + x + " " + y) ; 

} 

private int x, y ; 

} 

class Pointcol extends Point 

{ public Pointcol (int x, int y, byte couleur) 

{ super (x, y) ; // obligatoirement comme premiere instruction 

this. couleur = couleur ; 

} 

public void affiche () 
{ super .affiche () ; 

System. out. println (" et ma couleur est : " + couleur) ; 

} 

private byte couleur ; 

} 

public class TabHeter 

{ public static void main (String args[ ] ) 
{ Point [ ] tabPts = new Point [ 4] ; 
tabPts [ 0] = new Point (0, 2) ; 
tabPts [ 1] = new Pointcol (1, 5, (byte) 3) ; 
tabPts [ 2] = new Pointcol (2, 8, (byte) 9) ; 
tabPts [ 3] = new Point (1, 2) ; 

for (int i=0 ; i< tabPts . length ; i++) tabPts[ i] . affiche () ; 

} 

} 

Je suis en 0 2 
Je suis en 1 5 

et ma couleur est : 3 
Je suis en 2 8 

et ma couleur est : 9 
Je suis en 1 2 



Exemple d' utilisation du polymorphisme pour gerer un tableau heterogene 
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6.2 Generalisation a plusieurs classes 

Nous venons de vous exposer les fondements du polymorphisme en ne considerant que deux 
classes. Mais il va de soi qu'ils se generalisent a une hierarchie quelconque. Considerons a 
nouveau la hierarchie de classes presentee au paragraphe 5.3, dans laquelle seules les classes 
marquees d'un asterisque definissent ou redefinissent la methode/: 




Avec ces declarations : 

A a ; B b ; C c ; D d ; E e ; F f ; 

les affectations suivantes sont legales : 

a = b ; a = c ; a = d ; a = e ; a =f ; 
b = d ; b = e ; 
c = f ; 

En revanche, celles-ci ne le sont pas : 

b = a ; // erreur : A ne descend pas de B 
d = c ; // erreur : C ne descend pas de D 
c = d ; // erreur : D ne descend pas de C 

Voici quelques exemples precisant la methode / appelee, selon la nature de l'objet effective - 
ment reference par a (de type A) : 

a reference un objet de type A : methode/de A 

a reference un objet de type B : methode/de A 

a reference un objet de type C : methode/de C 

a reference un objet de type D : methode/de D 

a reference un objet de type E : methode/de A 

a reference un objet de type F : methode/de C. 
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Cet exemple est tres proche de celui presente au paragraphe 5.2 a propos de la redefinition 
d'une methode. Mais ici, la variable contenant la reference a un objet de l'une des classes 
est toujours de type A, alors que, auparavant, elle etait du type de l'objet reference. 
L' exemple du paragraphe 6.3 peut en fait etre considere comme un cas particulier de 
celui-ci. 



Dans les exemples precedents, les methodes affiche de Point et de Pointcol se contentaient 
d'afficher les valeurs des champs concernes, sans preciser la nature exacte de l'objet. Nous 
pourrions par exemple souhaiter que F information se presente ainsi pour un objet de type 
Point : 

Je suis un point 

Mes coordonnees sont : 0 2 

et ainsi pour un objet de type Pointcol : 

Je suis un point colore de couleur 3 
Mes coordonnees sont : 1 5 

On peut considerer que r information affichee par chaque classe se decompose en deux 
parties : une premiere partie specifique a la classe derivee (ici Pointcol), une seconde partie 
commune correspondant a la partie heritee de Point : les valeurs des coordonnees. D'une 
maniere generale, ce point de vue pourrait s'appliquer a toute classe descendant de Point. 
Dans ces conditions, plutot que de laisser chaque classe descendant de Point redefnir la 
methode affiche, on peut definir la methode affiche de la classe point de maniere qu'elle : 

• affiche les coordonnees (action commune a toutes les classes), 

• fasse appel a une autre methode (nommee par exemple identifie) ayant pour vocation d'af- 
ficher les informations specifiques a chaque objet. Ce faisant, nous supposons que chaque 
descendante de Point redefinira identifie de facon appropriee (mais elle n'aura plus a pren- 
dre en charge l'affichage des coordonnees). 

Cette demarche nous conduit a definir la classe Point de la facon suivante : 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 

} 

public void affiche () 
{ identifie () ; 

System. out .println (" Mes coordonnees sont : " + x + " " + y) ; 

} 



6.3 Autre situation ou I'on exploite le polymorphisme 
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public void identifie () 

{ System. out. println ("Je suis un point ") ; 
} 

private int x, y ; 

} 

Derivons une classe Pointcol en redefinissant comme voulu la methode identifie : 

class Pointcol extends Point 
{ 

public Pointcol (int x, int y, byte couleur) 
{ super (x, y) ; 

this . couleur = couleur ; 

} 

public void identifie () 

{ System. out. println ("Je suis un point colore de couleur " + couleur) ; 
} 

private byte couleur ; 

} 

Considerons alors ces instructions : 

Pointcol pc = new Pointcol (8, 6, (byte) 2) ; 
pc.affiche () ; 

L'instruction pc.ajfiche() entraine l'appel de la methode ajfiche de la classe Point (puisque 
cette methode n'a pas ete redefinie dans Pointcol). Mais dans la methode ajfiche de Point, 
l'instruction identifief) appelle la methode identifie de la classe correspondant a l'objet effec- 
tivement concerne (autrement dit, celui de reference this). Comme ici, il s'agit d'un objet de 
type Pointcol, il y aura bien appel de la methode identifie de Pointcol. 

La me me analyse s'appliquerait a la situation : 

Point p 

p = new Pointcol (8, 6, (byte) 2) ; 
p . af f iche ( ) ; 

La encore, c'est le type de l'objet reference par p qui interviendra dans le choix de la 
methode ajfiche. 

Voici un programme complet reprenant les definitions des classes Point et Pointcol utilisant la 
meme methode main que l'exemple du paragraphe 6.1 pour gerer un tableau heterogene : 

class Point 

{ public Point (int x, int y) 
{ this.x = x ; this.y = y ; 
} 

public void affiche () 
{ identifie () ; 

System . out . println (" Mes coordonnees sont : " + x + " " + y) ; 

} 
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public void identifie () 

{ System. out. println ("Je suis un point ") ; 
} 

private int x, y ; 

} 

class Pointcol extends Point 

{ public Pointcol (int x, int y, byte couleur) 
{ super (x, y) ; 

this. couleur = couleur ; 

} 

public void identifie () 

{ System. out .println ("Je suis un point colore de couleur " + couleur) ; 
} 

private byte couleur ; 

} 

public class TabHet2 

{ public static void main (String args[ ] ) 
{ Point [ ] tabPts = new Point [ 4] ; 
tabPts [ 0] = new Point (0, 2) ; 
tabPts [ 1] = new Pointcol (1, 5, (byte) 3) ; 
tabPts [ 2] = new Pointcol (2, 8, (byte) 9) ; 
tabPts [ 3] = new Point (1, 2) ; 
for (int i=0 ; i< tabPts . length ; i++) 
tabPtst i] .afficheO ; 

} 

} 

Je suis un point 

Mes coordonnees sont : 0 2 
Je suis un point colore de couleur 3 

Mes coordonnees sont : 1 5 
Je suis un point colore de couleur 9 

Mes coordonnees sont : 2 8 
Je suis un point 

Mes coordonnees sont : 1 2 



La technique proposee ici s'applique a n'importe quel objet d'une classe descendant de 
Point, pour peu qu'elle redefinisse correctement la methode identifie. Le code de ajfiche 
de Point n'a pas besoin de connaitre ce que sont ou seront les descendants de la classe, ce 
qui ne Fempeche pas de les manipuler. 



Une autre situation ou le polymorphisme se revele indispensable 
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6.4 Polymorphisme, redefinition et surdefinition 

Par essence, le polymorphisme se fonde sur la redefinition des methodes. Mais il est aussi 
possible de surdefinir une methode ; nous avons expose au paragraphe 5.5 les regies concer- 
nant ces deux possibilites. Cependant, nous n'avions pas tenu compte alors des possibilites 
de polymorphisme qui peuvent conduire a des situations assez complexes. En voici un 
exemple : 
class A 

{ public void f (float x) { } 



} 

class B extends A 

{ public void f (float x) { } // redefinition de f de A 

public void f (int n) { } // surdefinition de f pour A et B 

} 

A a = new A ( . . . ) ; 

B b = new B ( . . . ) ; int n ; 

a. f(n) ; // appelle f (float) de A (ce qui est logique) 

b. f(n) ; // appelle f (int) de B comme on s' y attend 

a = b ; //a contient une reference sur un objet de type B 
a.f(n) ; // appelle f (float) de B et non f (int) 

Ainsi, bien que les instructions b.ffn) et a.f(n) appliquent toutes les deux une methode /a un 
objet de type B, elles n'appellent pas la meme methode. Voyons plus precisement pourquoi. 
En presence de l'appel a.f(n), le compilateur recherche la meilleure methode (regies de sur- 
definition) parmi toutes les methodes de la classe correspondant au type de a (ici A) ou ses 
ascendantes. Ici, il s'agit de void /(float x) de A. A ce stade done, la signature de la methode et 
son type de retour sont entierement figes. Lors de l'execution, on se fonde sur le type de 
l'objet reference par a pour rechercher une methode ayant la signature et le type de retour 
voulus. On aboutit alors a la methode void f (float x) de B, et ce malgre la presence (ega- 
lement dans B) d'une methode qui serait mieux adaptee au type de l'argument effectif. 

Ainsi, malgre son aspect ligature dynamique, le polymorphisme se fonde sur une signature et 
un type de retour definis a la compilation (et qui ne seront done pas remis en question lors de 
l'execution). 

6.5 Conversions des arguments effectifs 

Nous avons deja vu comment, lors de l'appel d'une methode, ses arguments effectifs pou- 
vaient etre soumis a des conversions implicites. Ces dernieres peuvent egalement intervenir 
dans la recherche d'une fonction surdefinie. 

Toutefois, nos exemples se limitaient jusqu'ici a des conversions implicites de types primi- 
tifs. Or, la conversion d'un type derive en un type de base est aussi une conversion implicite 
legale ; elle va done pouvoir etre utilisee pour les arguments effectifs d'une methode. Nous 
en allons en voir ici des exemples, d'abord dans des situations d'appel simple, puis dans des 
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situations de surdefinition. Aucune information nouvelle ne sera apportee ; nous nous conten- 
terons d'exploiter les regies deja rencontrees. 

6.5.1 Cas d'une methode non surdefinie 

Considerons tout d'abord cette situation (nous utilisons une methode statique/ d'une classe 
Util par souci de simplification) : 

class A 

{ public void identiteO 

{ System. out. println ("objet de type A") ; 
} 

} 

class B extends A 

{ / / pas de redefinition de identite ici 
} 

class Util 

{ static void f (A a) // f attend un argument de type A 

{ a . identite ( ) ; 
} 

} 



A a = new A() ; B b = new B() ; 

Util. f (a) ; // OK : appel usuel ; il affiche : "objet de type A" 

Util.f(b) ; // OK : une reference a un objet de type B 

// est compatible avec une reference a un objet de type A 
// 1' appel a. identite affiche : "objet de type A" 

Si, en revanche, nous modifions ainsi la definition de B : 

class B extends A 

{ public void identite () 

{ System. out. println ("objet de type B") ; // redefinition de identite 

} 

} 

f (b) ; // OK : une reference a un objet de type B 

// est compatible avec une reference a un objet de type A 

// mais cet appel affiche : "objet de type B" 

L' appel f(b) entraine toujours la conversion de b en A. Mais dans/, l'appel a.identite() con- 
duit a l'appel de la methode identite definie par le type de l'objet reellement reference par a 
et Ton obtient bien l'affichage de "objet de type B". 

Cet exemple montre que, comme dans les situations d' affectation, la conversion implicite 
d'un type derive dans un type de base n'est pas degradante puisque, grace au polymorphisme, 
c'est bien le type de l'objet reference qui interviendra. 

6.5.2 Cas d'une methode surdefinie 

Voici un premier exemple relativement naturel (la encore, l'utilisation de methodes/statiques 
n'est destine qu'a simplifier les choses) : 



6 - Le polymorphisme 



219 



class A { } 

class B extends A { } 

class Util 

{ static void f (int p, B b) { } 

static void f (float x, A a) { } 

} 



A a = new A() ; B b = 
int n ; float x ; 
Util.ffn, b) ; // 
Util.f(x, a) ; // 
Util.f(n, a) ; // 
Util.f(x, b) ; // 



new B() ; 

OK sans conversions : 
OK sans conversions : 
conversion de n en float 
conversion de b en A : 



appel de f(int, B) 
appel de f (float, A) 
: appel de f (float, A) 
appel de f (float, A) 



Voici un second exemple, un peu moins trivial : 

class A { } 

class B extends A { } 

class Util 

{ static void f (int p, A a) 
{ } 

static void f (float x, B b) 




A a = new A() ; 
int n ; float x 



Util.f (n, 
Util.f (x, 
Util.f (n, 



Util.ffx, a ) 



b 



// OK sans conversions : appel de f (int, A) 

// OK sans conversions : appel de f (float, B) 

// erreur compilation car ambigu : deux possibilites : 
// soit convertir n en float et utiliser f (float, B) 
// soit convertir b en A et utiliser f (int, A) 

// erreur compilation : aucune fonction ne convient 
// (on ne peut pas convertir implicitement de A en B 
// ni de float en int) 



6.6 Les regies du polymorphisme en Java 

Dans les situations usuelles, le polymorphisme est facile a comprendre et a exploiter. Cepen- 
dant, nous avons vu que Tabus des possibilites de surdefinition des methodes pouvait con- 
duire a des situations complexes. Aussi, nous vous proposons ici de recapituler les differentes 
regies rencontrees progressivement dans ce paragraphe 6. 
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Compatibilite. II existe une conversion implicite d'une reference a un 
objet de classe Ten une reference a un objet d'une classe ascendante 
de 7" (elle peut intervenir aussi bien dans les affectations que dans les 
arguments effectifs). 

Ligature dynamique. Dans un appel de la forme x.f(...) ou xest sup- 
pose de classe T, le choix de f est determine ainsi : 

- a la compilation : on determine dans la classe Tou ses ascendantes la 
signature de la meilleure methode f convenant a I'appel, ce qui definit du 
meme coup le type de la valeur de retour. 

- a I'execution : on recherche la methode f de signature et de type de 
retour voulus (avec possibilites de covariance depuis le JDK 5.0), a partir 
de la classe correspondent au type effectif de I'objet reference par x (il 
est obligatoirement de type 7ou descendant) ; si cette classe ne com- 
porte pas de methode appropriee, on remonte dans la hierarchie jusqu'a 
ce qu'on en trouve une (au pire, on remontera jusqu'a 7). 



6.7 Les conversions explicites de references 

Nous avons largement insiste sur la compatibilite qui existe entre reference a un objet d'un 
type donne et reference a un objet d'un type ascendant. Comme on peut s'y attendre, la com- 
patibilite n'a pas lieu dans le sens inverse. Considerons cet exemple, fonde sur nos classes 
Point et Pointcol habituelles : 

class Point { } 

class Pointcol extends Point { } 



Pointcol pc ; 

pc = new Point (...) ; // erreur de compilation 

Si Faffectation etait legale, un simple appel tel que pc.coloref...) conduirait a attribuer une 
couleur a un objet de type Point, ce qui poserait quelques problemes a I'execution... 

Mais considerons cette situation : 

Point p ; 

Pointcol pel = new Pointcol (...), pc2 ; 



p = pel ; // p contient la reference a un objet de type Pointcol 



pc2 = p ; // refuse en compilation 

L' affectation pc2 = p est tout naturellement refusee. Cependant, nous sommes certains que p 
contient bien ici la reference a un objet de type Pointcol. En fait, nous pouvons forcer le com- 
pilateur a realiser la conversion correspondante en utilisant l'operateur de cast deja rencontre 
pour les types primitifs. Ici, nous ecrirons simplement : 

pc2 = (Pointcol) p ; // accepte en compilation 

Toutefois, lors de I'execution, Java s'assurera que p contient bien une reference a un objet de 
type Pointcol (ou derive) afin de ne pas compromettre la bonne execution du programme. 
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Dans le cas contraire, on obtiendra une exception ClassCastException qui, si elle n'est pas 
traitee (comme on apprendra a le faire au chapitre 10), conduira a un arret de F execution. 

Comme on peut s'y attendre, ce genre de conversion explicite n'est a utiliser qu'en toute con- 
naissance de cause. 

Remarque 

On peut s'assurer qu'un objet est bien une instance d'une classe donnee en recourant a 
l'operateur instanceOf. Par exemple, l'expression p instanceOf Point vaudra true si p est 
(exactement) de type Point. 

6.8 Le mot-cle super 

Nous avons deja vu comment le mot-cle super permettait d'appeler un constructeur d'une 
classe de base. En fait, il possede egalement un autre role, celui de forcer l'appel d'une 
methode quelconque d'une classe de base. En voici un exemple : 

class A 

{ void f () { } 

class B extends A 

{ void f () { } 

public void test() 

{ this.f () ; // appelle f de B 

super. f () ; // appelle f de A 

} 

} 

Cette fois, contrairement a ce qui etait impose dans le cas de l'appel de constructeur, l'appel 
super.fi) n'a nul besoin d'etre la premiere instruction de la methode (ici test). D'une maniere 
generate un appel tel que super.fi) remonte la hierachie d'heritage, a partir de l'ascendant 
direct de la classe concernee, jusqu'a trouver la methode voulue (ce qui, rappelons-le, n' etait 
pas le cas dans un constructeur). 

6.9 Limites de I'heritage et du polymorphisme 

La puissance des techniques d'heritage et de polymorphisme finit parfois par en faire oublier 
les regies exactes et les limitations qui en decoulent. 

Considerez la situation suivante dans laquelle : 

• la classe Point dispose d'une methode identique fournissant la valeur true lorsque le point 
fourni en argument a les memes coordonnees que le point courant : 

Point pi, p2 ; 

pi . identique (p2 ) // true si pi et p2 ont memes coordonnees 

• la classe Pointcol, derivee de Point, redefinit cette methode pour prendre en compte non 
seulement l'egalite des coordonnees, mais aussi celle de la couleur : 
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Pointcol pel, pc2 ; 

pel . identique (pc2) // true si pel et pc2 ont merries coordonnees et meme couleur 

Considerons alors : 

Point pi = new Pointcol (1, 2, (byte) 5) ; 
Point p2 = new Pointcol (1, 2, (byte) 8) ; 

L' expression pl.identique(p2) a pour valeur true alors que nos deux points colores n'ont pas 
la meme couleur. L' explication reside tout simplement dans la bonne application des regies 
relatives au polymorphisme. En effet, lors de la compilation de cette expression pl.identi- 
que(p2), on s'est fonde sur le type de pi pour en deduire que l'en-tete de la methode identi- 
que a appeler etait de la forme Point identique (Point). Lors de F execution, la ligature 
dynamique tient compte du type de Fobjet reellement reference par pi (ici Pointcol) pour 
definir la classe a partir de laquelle se fera la recherche de la methode voulue. Mais comme 
dans Pointcol, la methode identique n'a pas la signature voulue, on poursuit la recherche dans 
les classes ascendantes et, finalement, on utilise la methode identifie de Point. D'ou le resultat 
constate. 



7 La super-classe Object 

Jusqu'ici, nous pouvons considerer que nous avons defini deux sortes de classes : des classes 
simples et des classes derivees. 

En realite, il existe une classe nommee Object dont derive implicitement toute classe simple. 
Ainsi, lorsque vous definissez une classe Point de cette maniere : 

class Point 

{ 

} 

tout se passe en fait comme si vous aviez ecrit (vous pouvez d'ailleurs le faire) : 

class Point extends Object 

{ 

} 

Voyons les consequences de cette propriete. 



7.1 Utilisation d'une reference de type Object 

Compte tenu des possibilites de compatibilite exposees precedemment, une variable de type 
Object peut etre utilisee pour referencer un objet de type quelconque : 

Point p = new Point (...) ; 
Pointcol pc = new Pointcol (...) ; 
Fleur f = new Fleur (...) ; 
Object o ; 
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o = p ; //OK 
o = pc ; // OK 
o = f ; //OK 

Cette particularite peut etre utilisee pour manipuler des objets dont on ne connait pas le type 
exact (au moins a un certain moment). Cela pourrait etre le cas d'une methode qui se con- 
tente de transmettre a une autre methode une reference qu'elle a recue en argument. 

Bien entendu, des qu'on souhaitera appliquer une methode precise a un objet reference par 
une variable de type Object, il faudra obligatoirement effectuer une conversion appropriee. 

Voyez cet exemple ou Ton suppose que la classe Point dispose de la methode deplace : 

Point p = new Point (...) ; 



Notez bien les consequences des regies relatives au polymorphisme. Pour pouvoir appeler 
une methode/par o.f( ), il ne suffit pas que l'objet effectivement reference par o soit d'un type 
comportant une methode/, il faut aussi que ladite methode existe deja dans la classe Object. 
Ce n'est manifestement pas le cas de la methode deplace. 



La classe Object dispose de quelques methodes qu'on peut soit utiliser telles quelles, soit 
redefinir. Les plus importantes sont toString et equals. 

7.2.1 La methode toString 

Elle foumit une chaine, c'est-a-dire un objet de type String. Cette classe sera etudiee ulterieu- 
rement mais, comme on peut s'y attendre, un objet de type String contient une suite de carac- 
teres. La methode toString de la classe Object fournit une chaine contenant : 

• le nom de la classe concernee, 

• Fadresse de l'objet en hexadecimal (precedee de @). 
Voyez ce petit programme : 

class Point 

{ public Point (int abs, int ord) 
{ x = abs ; y = ord ; 
} 

private int x, y ; 



Object o ; 



o = p ; 

o . deplace ( ) ; 

( ( Point ) o ) . deplace ( ) ; 

Point pi = (Point) o ; 

pi . deplace ( ) ; 



// erreur de compilation 

// OK en compilation (attention aux parentheses) 

// OK : idem ci-dessus, avec creation d une reference 

// intermediaire dans pi 



7.2 Utilisation de methodes de la classe Object 
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public class ToStringl 

{ public static void main (String args[ ] ) 
{ Point a = new Point (1, 2) ; 
Point b = new Point (5, 6) ; 
System. out. println ("a = " + a . toString ( ) ) ; 
System. out. println ("b = " + b. toString () ) ; 

} 

} 

a = Point@fcl7aedf 
b = Point@fclbaedf 

Exemple d' utilisation a" utilisation de la methode toString 

II est interessant de noter que le nom de classe est bien le nom de la classe correspondant a 
l'objet reference, meme si toString n'a pas ete redefinie. En effet, la methode toString de la 
classe Object utilise une technique dite de "fonction de rappel", analogue a celle que nous 
avons employee avec la methode identifie de l'exemple du paragraphe 6.3. Plus precisement, 
elle appelle une methode getClass 1 qui fournit la classe de l'objet reference sous forme d'un 
objet de type Class contenant, entre autres, le nom de la classe. 

Bien entendu, vous pouvez toujours redefinir la methode toString a votre convenance. Par 
exemple, dans notre classe Point, nous pourrions lui faire fournir une chaine contenant les 
coordonnees du point... 

La methode toString d'une classe possede en outre la particularite d'etre automatiquement 
appelee en cas de besoin d'une conversion implicite en chaine. Nous verrons que ce sera le 
cas de l'operateur + lorsqu'il dispose d'un argument de type chaine, ce qui vous permettra 
d'ecrire par exemple : 

System. out. println ("mon objet = " + o) ; 

et ce, quels que soient le type de la reference o et celui de l'objet effectivement reference par 
o. 

7.2.2 La methode equals 

La methode equals definie dans la classe Object se contente de comparer les adresses des 
deux objets concernes. Ainsi, avec : 

Object ol = new Point (1, 2) ; 
Object o2 = new Point (1, 2) ; 

L'expression ol.equals(o2) a pour valeur false. 

On peut bien sur redefinir cette methode a sa guise dans n'importe quelle classe. Toutefois, il 
faudra tenir compte des limitations du polymorphisme evoquees au paragraphe 6.9. Ainsi, 
avec : 



1. Cette methode est introduite automatiquement par Java dans toutes les classes. 
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class Point 
{ 

boolean equals (Point p) { return ((p.x==x) && (p.y==y)) ; } 

} 

Point a = new Point (1, 2) ; 
Point b = new Point (1, 2) ; 

1' expression a.equals(b) aura bien sur la valeur true. En revanche, avec : 

Object ol = new Point (1, 2) ; 
Object o2 = new Point (1, 2) ; 

1' expression ol.equals(o2) aura la valeur false car on aura utilise la methode equals de Object 
et non celle de Point. 



8 Les membres proteges 

Nous avons deja vu qu'il existe differents droits d'acces aux membres d'une classe : public 
(mot-cle public), prive (mot-cle private), de paquetage (aucune mention). 

II existe un quatrieme droit d'acces dit protege (mot-cle protected). Mais curieusement, les 
concepteurs de Java le font intervenir a deux niveaux totalement differents : le paquetage de 
la classe d'une part, ses classes derivees d' autre part. 

En effet, un membre declare protected est accessible a des classes du meme paquetage, ainsi 
qu'a ses classes derivees (qu'elles appartiennent ou non au meme paquetage). Cette particu- 
lar! te complique quelque peu la conception des classes, ce qui fait qu'en pratique, ce droit 
d'acces est peu employe. 



Of" 



En C++ 



6 



On peut declarer des membres proteges (a l'aide du mot-cle protected). lis ne sont alors 
accessibles qu'aux classes derivees, ce qui fait que Faeces protege est beaucoup plus usite 
en C++ qu'en Java. 

» 

Informations complementaires 

Considerez une classe A ainsi definie : 

class A 

{ 

protected int n ; 

} 
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et quelques descendantes de A sous la forme suivante : 




Dans ces conditions : 

- B accede a n de A, 

- D accede a n de B ou de A, 

- mais C n' accede pas a«deB (sauf si B et C sont dans le meme paquetage) car aucun 
lien de derivation ne relie B et C. 



9 Cas particulier des tableaux 



Jusqu'ici, nous avons considere les tableaux comme des objets. Cependant, il n'est pas possi- 
ble de definir exactement leur classe. En fait les tableaux ne jouissent que d'une partie des 
proprietes des objets. 

1. Un tableau peut etre considere comme appartenant a une classe derivee de Object : 



Object o ; 

o = new int [ 5] 



new float [ 3] 



// correct 



// OK 



2. Le polymorphisme peut s'appliquer a des tableaux d' objets. Plus precisement, si B 
derive de A, un tableau de B est compatible avec un tableau de A : 



class B extends A { 
A ta[ ] ; 
B tit ] ; 



ta 
tb 



tb ; 
ta ; 



//OK car 
// erreur 



derive de A 



Malheureusement, cette propriete ne peut pas s'appliquer aux types primitifs 

int ti[ ] ; float tf[ ] ; 



ti = tf ; // erreur (on s' y attend car float n' est pas compatible avec int) 
tf = ti ; // erreur bien que int soit compatible avec float 
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3. II n'est pas possible de deriver une classe d'une hypothetique classe tableau : 

class Bizarre extends int [ ] // erreur 

Remarque 

Cette propriete des tableaux d'objets derives ne se retrouvera pas dans les collections 
generiques. Ainsi un ArrayList <B> (collection d'objets de type B, ressemblant a un 
tableau) ne sera pas compatible avec un ArrayList <A>. 

10 Classes et methodes finales 

Nous avons deja vu comment le mot-cle final pouvait s'appliquer a des variables locales ou a 
des champs d'une classe. II interdit la modification de leur valeur. Ce mot-cle peut aussi 
s'appliquer a une methode ou a une classe, mais avec une signification totalement differente : 

Une methode declaree final ne peut pas etre redefinie dans une classe 
derivee. 

Le comportement d'une methode finale 1 est done completement defini et il ne peut plus etre 
remis en cause, sauf si la methode appelle elle-meme une methode qui n'est pas declaree 
final. 

Une classe declaree final ne peut plus etre derivee 
On est ainsi certain que le contrat de la classe sera respecte. 

On pourrait croire qu'une classe finale est equivalente a une classe non finale dont toutes les 
methodes seraient finales. En fait, ce n'est pas vrai car : 

• ne pouvant plus etre derivee, une classe finale ne pourra pas se voir ajouter de nouvelles 
fonctionnalites, 

• une classe non finale dont toutes les methodes sont finales pourra toujours etre derivee, done 
se voir ajouter de nouvelles fonctionnalites. 

Par son caractere parfaitement defini, une methode finale permet au compilateur : 

• de detecter des anomalies qui, sans cela, n'apparaitraient que lors de 1' execution, 

• d'optimiser certaines parties de code : appels plus rapides puisque independants de l'execu- 
tion, mise "en ligne" du code de certaines methodes... 

En revanche, il va de soi que le choix d'une methode ou d'une classe finale est tres contrai- 
gnant et ne doit etre fait qu'en toute connaissance de cause. 



1 . Nous commettrons l'abus de langage qui consiste a parler d'une classe finale pour designer une classe decla- 
ree avec l'attribut final. 
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1 1 Les classes abstraites 

11.1 Presentation 

Une classe abstraite est une classe qui ne permet pas d'instancier des objets. Elle ne peut ser- 
vir que de classe de base pour une derivation. Elle se declare ainsi : 

abstract class A 

{ 

} 

Dans une classe abstraite, on peut trouver classiquement des methodes et des champs, dont 
heritera toute classe derivee. Mais on peut aussi trouver des methodes dites abstraites, c'est- 
a-dire dont on ne fournit que la signature et le type de la valeur de retour. Par exemple : 

abstract class A 

{ public void f() { } // f est definie dans A 

public abstract void g(int n) ; // g n' est pas definie dans A ; on n' en 

//a fourni que 1' en-tete 

} 

Bien entendu, on pourra declarer une variable de type A : 

A a ; // OK : a n' est qu' une reference sur un objet de type A ou derive 

En revanche, toute instanciation d'un objet de type A sera rejetee par le compilateur : 

a = new A(. . .) ; // erreur : pas d' instanciation <J objets d une classe abstraite 

En revanche, si on derive de A une classe B qui definit la methode abstraite g : 

class B extends A 

{ public void g(int n) { } // ici, on definit g 

} 

on pourra alors instancier un objet de type B par new B(...) et meme affecter sa reference a 
une variable de type A : 

A a = new B(. . .) ; //OK 

1 1 .2Quelques regies 

1. Des qu'une classe comporte une ou plusieurs methodes abstraites, elle est abstraite, et ce 
meme si Ton n'indique pas le mot-cle abstract devant sa declaration (ce qui reste quand 
meme vivement conseille). Ceci est correct : 

class A 

{ public abstract void f() ; //OK 
} 

Malgre tout, A est considered comme abstraite et une expression telle que new A(...) 
sera rejetee. 
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2. Une methode abstraite doit obligatoirement etre declaree public, ce qui est logique puisque 
sa vocation est d'etre redefinie dans une classe derivee. 

3. Dans l'en-tete d'une methode declaree abstraite, les noms d' arguments muets doivent fi- 
gurer (bien qu'ils ne servent a rien) : 

abstract class A 

{ public abstract void g(int) ; // erreur : nom d' argument (fictif) obligatoire 



4. Une classe derivee d'une classe abstraite n'est pas obligee de (re)definir toutes les metho- 
des abstraites de sa classe de base (elle peut meme n'en redefinir aucune). Dans ce cas, elle 
reste simplement abstraite (il est quant meme necessaire de mentionner abstract dans sa 
declaration) : 

abstract class A 

{ public abstract void fl() ; 

public abstract void f2 (char c) ; 



} 

Ici, B definit/7, mais pas/2. La classe B reste abstraite (meme si on ne l'a pas declaree 
ainsi). 

5. Une classe derivee d'une classe non abstraite peut etre declaree abstraite et/ou contenir des 
methodes abstraites. Notez que, toutes les classes derivant de Object, nous avons utilise 
implicitement cette regie dans tous les exemples precedents. 



L' utilisation du meme mot-cle abstract pour les classes et pour les methodes fait que Ton 
parle en Java de classes abstraites et de methodes abstraites. En programmation orientee 
objet, on parle aussi de classe abstraite pour designer une classe non instanciable ; en 
revanche, on parle generalement de methode differee ou retardee pour designer une 
methode qui doit etre redefinie dans une classe derivee. 



Le recours aux classes abstraites facilite largement la conception orientee objet. En effet, on 
peut placer dans une classe abstraite toutes les fonctionnalites dont on souhaite disposer pour 
toutes ses descendantes : 

• soit sous forme d'une implementation complete de methodes (non abstraites) et de champs 
(prives ou non) lorsqu'ils sont communs a toutes ses descendantes, 



abstract class B extends A 
{ public void fl () { .... 



// abstract obligatoire ici 

// definition de fl 

// pas de definition de f2 




Remarqi 



iue 



1 1 .3lnteret des classes abstraites 
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• soit sous forme d' interface de methodes abstraites dont on est alors stir qu'elles existeront 
dans toute classe derivee instanciable. 

C'est cette certitude de la presence de certaines methodes qui permet d'exploiter le polymor- 
phisme, et ce des la conception de la classe abstraite, alors meme qu'aucune classe derivee 
n'a peut-etre encore ete creee. Notamment, on peut tres bien ecrire des canevas recourant a 
des methodes abstraites. Par exemple, si vous avez defini : 

abstract class X 

{ public abstract void f() ; // ici, f n' est pas encore definie 
} 

vous pourrez ecrire une methode (d'une classe quelconque) telle que : 

void algo (X x) 



x.f () ; // appel correct ; accepte en compilation 

//on est sur que tout objet d' une classe derivee de X 

// disposera bien d une methode f 

} 

Bien entendu, la redefinition de/devra, comme d' habitude, respecter la semantique prevue 
dans le contrat de X. 



Voici un exemple de programme illustrant l'emploi d'une classe abstraite nommee Afficha- 
ble, dotee d'une seule methode abstraite affiche. Deux classes Entier et Flottant derivent de 
cette classe. La methode main utilise un tableau heterogene d'objets de type Affichable 
qu'elle remplit en instanciant des objets de type Entier et Flottant. 

abstract class Affichable 

{ abstract public void affiche () ; 

} 

class Entier extends Affichable 
{ public Entier (int n) 

{ valeur = n ; 

} 

public void affiche () 

{ System. out .println ("Je suis un entier de valeur " + valeur) ; 
} 

private int valeur ; 



1 1 .4 Exemple 



class Flottant extends Affichable 
{ public Flottant (float x) 
{ valeur = x ; 
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public void af f iche ( ) 

{ System. out. println ("Je suis un flottant de valeur " + valeur) ; 
} 

private float valeur ; 

} 

public class Tabhet3 

{ public static void main (String ] args) 
{ Af fichable [ ] tab ; 

tab = new Af fichable [ 3] ; 

tab [ 0] = new Entier (25) ; 

tab [ 1] = new Flottant (1.25f) ; ; 

tab [ 2] = new Entier (42) ; 

int i ; 

for (i=0 ; i<3 ; i++) 
tab i] .afficheO ; 

} 

} 

Je suis un entier de valeur 25 

Je suis un flottant de valeur 1 . 25 

Je suis un entier de valeur 42 

Exemple d' utilisation d'une classe abstraite (Affichablej 

Remarque 

Un classe abstraite peut ne comporter que des methodes abstraites et aucun champ. C'est 
d'ailleurs ce qui se produit ici. Dans ce cas, nous verrons qu'une interface peut jouer le 
meme role ; nous montrerons comment transformer dans ce sens F exemple precedent. 

12 Les interfaces 

Nous venons de voir comment une classe abstraite permettait de definir dans une classe de 
base des fonctionnalites communes a toutes ses descendantes, tout en leur imposant de rede- 
finir certaines methodes. Si Ton considere une classe abstraite n'implantant aucune methode 
et aucun champ (hormis des constantes), on aboutit a la notion d' interface. En effet, une 
interface definit les en-tetes d'un certain nombre de methodes, ainsi que des constantes. 
Cependant, nous allons voir que cette derniere notion se revele plus riche qu'un simple cas 
particulier de classe abstraite. En effet : 

• une classe pourra implementer plusieurs interfaces (alors qu'une classe ne pouvait deriver 
que d'une seule classe abstraite), 

• la notion d'interface va se superposer a celle de derivation, et non s'y substituer, 
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• les interfaces pourront se deriver, 

• on pourra utiliser des variables de type interface. 

Commencons par voir comment on definit une interface et comment on l'utilise, avant d'en 
etudier les proprietes en detail. 



La definition d'une interface se presente comme celle d'une classe. On y utilise simplement 
le mot-cle interface a la place de class : 

public interface I 

{ void f (int n) ; // en-tete cf une methode f (public abstract facultatifs) 



} 

Une interface peut etre dotee des memes droits d'acces qu'une classe (public ou droit de 
paquetage). 

Dans la definition d'une interface, on ne peut trouver que des en-tetes de methodes (cas de/ 
et g ici) ou des constantes (nous reviendrons plus loin sur ce point). Par essence, les methodes 
d'une interface sont abstraites (puisqu'on n'en fournit pas de definition) et publiques 
(puisqu'elles devront etre redefinies plus tard). Neanmoins, il n'est pas necessaire de men- 
tionner les mots-cles public et abstract (on peut quand meme le faire). 

12.1.2 Implementation d'une interface 

Lorsqu'on definit une classe, on peut preciser qu'elle implemente une interface donnee en 
utilisant le mot-cle implements, comme dans : 

class A implements I 

{ // A doit (re) definir les methodes f et g prevues dans 1' interface I 
} 

Ici, on indique que A doit definir les methodes prevues dans l'interface /, c'est-a-dire/et g. Si 
cela n'est pas le cas, on obtiendra une erreur de compilation (attention : on ne peut pas diffe- 
rer cette definition de methode, comme on pourrait eventuellement le faire dans le cas d'une 
classe abstraite). 

Une meme classe peut implementer plusieurs interfaces : 



public interface II 
{ void f () ; 

public interface 12 
{ int h() ; 

class A implements II, 12 

{ //A doit obligatoirement definir les methodes f et h prevues dans II et 12 



12.1 Mise en oeuvre d'une interface 



12.1.1 Definition d'une interface 



void g() 



// en-tete cf une methode g (public abstract facultatifs) 
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12. 2 Variables de type interface et polymorphisme 

Bien que la vocation d'une interface soit d'etre implemented par une classe, on peut definir 
des variables de type interface : 

public interface I { } 



I i ; // i est une reference a un objet d' une classe implementant 1' interface I 

Bien entendu, on ne pourra pas affecter a i une reference a quelque chose de type /puisqu'on 
ne peut pas instancier une interface (pas plus qu'on ne pouvait instancier une classe 
abstraite !). En revanche, on pourra affecter a i n'importe quelle reference a un objet d'une 
classe implementant F interface / : 

class A implements I { } 



I i = new A(. . .) ; //OK 

De plus, a travers i, on pourra manipuler des objets de classes quelconques, non 
necessairement liees par heritage, pour peu que ces classes implementent l'interface /. 

Voici un exemple illustrant cet aspect. Une interface Affichable comporte une methode affi- 
che. Deux classes Entier et Flottant implementent cette interface (aucun lien d'heritage 
n'apparait ici). On cree un tableau heterogene de references de "type" Affichable qu'on rem- 
plit en instanciant des objets de type Entier et Flottant. En fait, il s'agit d'une transposition 
de l'exemple de programme du paragraphe 1 1.4 qui utilisait des classes abstraites. 

interface Affichable 
{ void afficheO ; 
} 

class Entier implements Affichable 
{ public Entier (int n) 

{ valeur = n ; 

} 

public void af f iche ( ) 

{ System. out. println ("Je suis un entier de valeur " + valeur) ; 
} 

private int valeur ; 

) 

class Flottant implements Affichable 
{ public Flottant (float x) 

{ valeur = x ; 

} 

public void afficheO 

{ System. out. println ("Je suis un flottant de valeur " + valeur) ; 
} 

private float valeur ; 

} 

public class Tabhet4 

{ public static void main (String! ] args) 
{ Affichable [ ] tab ; 

tab = new Affichable [ 3] ; 
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tab [ 0] = new Entier (25) ; 

tab [ 1] = new Flottant (1.25f) ; ; 

tab [ 2] = new Entier (42) ; 

int i ; 

for (i=0 ; i<3 ; i++) 
tabl i] .afficheO ; 



Cet exemple est restrictif puisqu'il peut se traiter avec une classe abstraite. Voyons mainte- 
nant ce que l'interface apporte de plus. 



Ici, notre interface a ete declaree avec un droit de paquetage, et non avec l'attribut public, 
ce qui nous a permis de placer sa definition dans le meme fichier source que les autres 
classes (les droits d'acces des interfaces sont en effet regis par les memes regies que ceux 
des classes). En pratique, il en ira rarement ainsi, dans la mesure ou chaque interface dis- 
posera de son propre fichier source. 



La clause implements est une garantie qu'offre une classe d'implementer les fonctionnalites 
proposees dans une interface. Elle est totalement independante de l'heritage ; autrement dit, 
une classe derivee peut implementer une interface (ou plusieurs) : 

interface I 
{ void f (int n) ; 
void g ( ) ; 

} 

class A { } 

class B extends A implements I 

{ // les mmethodes f et g doivent soit etre deja definies dans A, 



Je suis un entier de valeur 25 

Je suis un flottant de valeur 1.25 

Je suis un entier de valeur 42 



Exemple d' utilisation de variables de type interface 



Remarque 



12.3 Interface et classe derivee 



/ / soit definies dans B 



On peut meme rencontrer cette situation : 



interface II { } 

interface 12 { } 

class A implements II { } 

class B extends A implements 12 { 
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12.4 Interfaces et constantes 

L'essentiel du concept d'interface reside dans les en-tetes de methodes qui y figurent. Mais 
une interface peut aussi renfermer des constantes symboliques qui seront alors accessibles a 
toutes les classes implementant 1' interface : 

interface I 
{ void f (int n) ; 
void g() ; 

static final int MAXI = 100 ; 

} 

class A implements I 

{ // doit definir f et g 

// dans toutes les methodes de A, on a acces au symbole MAXI : 

// par exemple : if (i < MAXI) 

} 

Ces constantes sont automatiquement considerees comme si elles avaient ete declarees static 
et final. II doit s'agir obligatoirement d'expressions constantes. 

Elles sont accessibles en dehors d'une classe implementant l'interface. Par exemple, la cons- 
tante MAXI de l'interface / se notera simplement I.MAXI. 

\^^~ Remarque 

On peut dire que, dans une interface, les methodes et les constantes sont considerees de 
maniere opposee. En effet, les methodes doivent etre implementees par la classe, tandis 
que les constantes sont utilisables par la classe. 

12.5 Derivation d'une interface 

On peut definir une interface comme une generalisation d'une autre. On utilise la encore le 
mot-cle extends, ce qui conduit a parler d' heritage ou de derivation, et ce bien qu'il ne 
s'agisse en fait que d'emboiter simplement des declarations : 

interface II 

{ void f (int n) ; 

static final int MAXI = 100 ; 

} 

interface 12 extends II 
{ void g() ; 

static final int MINI = 20 ; 

} 

En fait, la definition de 12 est totalement equivalente a : 

interface 12 
{ void f (int n) ; 
void g() ; 

static final int MAXI = 100 ; 
static final int MINI = 20 ; 

} 
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La derivation des interfaces revient simplement a concatener des declarations. II n'en va pas 
aussi simplement pour l'heritage de classes, ou les notions d'acces deviennent fondamentales. 



Considerons : 

interface II 
{ void f (int n) ; 
void g ( ) ; 

} 

interface 12 
{ void f (float x) ; 
void g ( ) ; 

} 

class A implements II, 12 

{ //A doit definir deux methodes f : void f (int) et void f (float), 
// mais une seule methode g : void g() 
En ce qui conceme la methode/, on voit que, pour implementer II et 12, la classe A doit sim- 
plement la surdefinir convenablement. En ce qui concerne la methode g, en revanche, il sem- 
ble qu'un conflit de noms apparaisse. En fait, il n'en est rien puisque les deux interfaces II et 
12 definissent le meme en-tete de methode g ; il suffit done que A definisse la methode requise 
(meme si elle elle demandee deux fois !). 

En revanche, considerons maintenant : 

interface II 
{ void f (int n) ; 
void g ( ) ; 

} 

interface 12 
{ void f (float x) ; 
int g() ; 

} 

class A implements II, 12 

{ // pour satisfaire a II et 12, A devrait contenir a la fois une methode 
// void g() et une methode int g(), ce qui n' est pas possible 
// d' apres les regies de redefinition 

} 

Cette fois, une classe ne peut implementer a la fois II et 12. 

Informations complementaires 

Au chapitre 10, nous verrons qu'une methode peut specifier par throws les exceptions 
qu'elles est susceptible de declencher. Rien n'empeche que les clauses throws d'une 
methode donnee different d'une interface a une autre ; par exemple, on pourrait avoir : 



12.6Conflits de noms 



void g() throws El, E2 ; 



dans II et : 
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void g ( ) throws El , E3 ; 

dans 12. 

Dans ce cas, 1' implementation de g dans A ne devra pas specifier plus d'exceptions que 
n'en specifie chacune des interfaces. Ainsi, on pourra rencontrer l'une de ces 
possibilites : 

void g ( ) throws El { } 

void g() { } 



Java dispose de quelques outils destines a faciliter la gestion du clonage des objets (copie 
profonde). 

Tout d'abord, la classe Object possede une methode clone protegee qui se contente d'effec- 
tuer une copie superficielle de l'objet. L'idee des concepteurs de Java est que cette methode 
doit etre redefinie dans toute classe clonable 

Par ailleurs, il existe une interface tres particuliere Cloneable. Ce nom s'emploie comme un 
nom d' interface dans une clause implements. Mais, contrairement a ce qui se produirait avec 
une interface usuelle, cette clause n'impose pas la redefinition de la methode clone. 

En fait, la declaration : 

class X implements Cloneable 
mentionne que la classe Xpeut subir une copie profonde par appel de la methode clone. Cette 
derniere peut etre celle de Object ou une methode fournie par X. 

Enfin, une tentative d' appel de clone sur une classe n'implementant pas Finterface Cloneable 
conduit a une exception CloneNotSupportedException. Vous pouvez egalement lever vous- 
meme une telle exception si vous decidez qu'un objet d'une classe (implementant l'interface 
Cloneable) n'est pas copiable ; vous realisez ainsi du clonage conditionnel. 

Notez que Fen-tete de clone est : 

Ob j ect clone ( ) ; 

Cela signifie que son utilisation necessite toujours un cast de son resultat dans le type effectif 
de l'objet soumis a copie. 



Comme on a pu le voir, les objets (instances d'une classe) et les variables (d'un type primitif) 
ne se comportent pas exactement de la meme maniere. Par exemple : 

• l'affectation porte sur l'adresse d'un objet, sur la valeur d'une variable, 

• les regies de compatibilite de l'affectation se fondent sur une hierarchie d'heritage pour les 
objets, sur une hierarchie de type pour les variables, 

• le polymorphisme ne s' applique qu'aux objets, 



12.7L 



interface Cloneable 
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• comme nous le verrons par la suite, les collections ne sont definies que pour des elements 
qui sont des objets. 

Les classes enveloppes (wrappers en anglais) vont permettre de manipuler les types primitifs 
comme des objets. Plus precisement, il existe des classes nominees Boolean, Character, 
Byte, Short, Integer, Long, Float et Double qui encapsulent des valeurs du type primitif cor- 
respondant (boolean, char, byte, short, hit, long, float et double). 

13.1 Construction et acces aux valeurs 

Toutes les classes enveloppes disposent d'un constructeur recevant un argument d'un type 
primitif : 

Integer nObj = new Integer (12) ; // nObj contient la reference a un objet 

// de type Integer encapsulant la valeur 12 

Double xObj = new Double (5.25) ; // xObj contient la reference a un objet 

// de type Double encapsulant la valeur 5.25 

Elles disposent toutes d'une methode de la forme xxxValue (xxx representant le nom du type 
primitif) qui permet de retrouver la valeur dans le type primitif correspondant : 

int n = nObj . intValue ( ) ; // n contient 12 

double x = xObj . doubleValue ( ) ; // x contient 5.25 

Nous verrons un peu plus loin que ces instructions peuvent etre abregees grace aux facilites 
dites de "boxing/unboxing" automatiques introduites par le JDK 5.0. 

Ces classes enveloppes sont finales (on ne peut pas creer de classes derivees) et inalterables 
puisque les valeurs qu'elles encapsulent ne sont pas modifiables. Les six classes a caractere 
numerique derivent de la classe Number. 

13.2Comparaisons avec la methode equals 

On n'oubliera pas que Foperateur == applique a des objets se contente d'en comparer les 
adresses. Ainsi, avec : 

Integer nObjl = new Integer (5) ; 
Integer n0bj2 = new Integer (5) ; 

il est probable que l'expression nObjl == nObjl aura la valeur false. Notez que cela n'est 
toutefois pas certain car rien n'interdit au compilateur de n'implementer qu'une seule fois 
des valeurs identiques. ; autrement dit, dans le cas present, il peut tres bien ne creer qu'un 
seul objet de type Integer contenant la valeur 5. 

En revanche, la methode equals a bien ete redefinie dans les classes enveloppes, de maniere a 
comparer effectivement les valeurs correspondantes. Ici, l'expression nObjl .equals(nObj2) 
aura toujours la valeur true. 
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13.3Emballage et deballage automatique (JDK 5.0) 

13.3.1 Presentation 

Avant le JDK 5.0, la manipulation des classes enveloppes devait se faire comme on l'a vu au 
paragraphe 13.1, a Faide d'appels explicites a des methodes : 

• le constructeur, pour creer un objet enveloppe a partir d'un type primitif ; on parle parfois 
d' emballage (boxing en anglais) ; 

• une methode de la forme xxxValue pour acceder a la valeur encapsulee dans Fobjet ; on parle 
alors de deballage (unboxing en anglais). 

Le JDK 5.0 a introduit des possiblites de conversions mises en place automatiquement par le 
compilateur ; on parle alors d' emballage ou de deballage automatique (autoboxing en 
anglais). Ainsi, les instructions du paragraphe 13.1 pourront s'ecrire : 

Integer nObj =12 // au lieu de : = new Integer (12) ; 

Double xObj= 5.25 ; // au lieu de : = new Double (5.25) ; 



int n = nObj ; // au lieu de : = nObj . intValue ( ) ; 

double x = xObj // au lieu de = xObj . doubleValue ( ) ; 

Dans la premiere affectation, la valeur entiere 12 est convertie en objet de type Integer et sa 
reference est affectee a nObj. De meme, dans la troisieme affectation (n = nObj), la valeur 
entiere encapsulee dans nObj est affectee a n. 

Dans des expressions arithmetiques, ces conversions s'ajoutent aux conversions implicites 
usuelles comme dans ces exemples ou Ton suppose que nObjl et nObjl sont de type Integer : 

nObjl = n0bj2 + 2 ; // nObj2 est converti en int auquel on ajoute 2 ; 

// le resultat est converti en Integer 

nObjl+t ; // nObjl est converti en int, auquel on ajoute 1 ; 

// le resultat est converti en Integer 

On notera toutefois que de telles operations arithmetiques, effectuees apparemment directe- 
ment sur des types enveloppes, peuvent s'averer relativement peu efficaces compte tenu des 
conversions supplementaires qu'elles entrainent lors de 1' execution du code. 

13.3.2 Limitations 

Ces conversions ne sont toutefois possibles qu'entre un type enveloppe et son type primitif 
correspondant. Ainsi, cette instruction est incorrecte (comme le serait 1' affectation 
double x = 5) : 

Double xObj = 5 ; // 5, de type int, ne peut pas etre converti en Double 

De meme, ceci est incorrect 

Integer nObj ; 

Double xObj = nObj ; // erreur de compilation 

En effet, il n'existe pas de conversion implicite de Integer en Double car il n'existe aucune 
relation d' heritage entre les deux classes (tout au plus, heritent-elles toutes les deux de 
Integer). 
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13.3.3 Consequences sur la surdefinition des methodes 

Les regies de recherche d'une methode surdefinie ont du etre completees par le JDK 5.0 pour 
tenir compte des possibilites d'emballage/deballage automatique, comme elles l'ont ega- 
lement ete pour tenir compte de 1' ellipse. Dans tous les cas, la compatibilite avec les versions 
precedentes de Java est assuree, ainsi un ancien code continue d' avoir le meme comporte- 
ment avec les nouvelles versions de Java. 

Depuis le JDK 5.0, la recherche d'une methode surdefinie se fait done tout d'abord sans tenir 
compte, ni des possiblites d'emballage/deballage automatique, ni de l'ellispe. Si aucune 
methode ne convient (et uniquement dans ce cas), on poursuit la recherche en acceptant les 
conversions d'emballage/deballage automatique. Si une seule methode convient, elle est 
choisie ; si plusieurs conviennent, il y a (comme d'habitude) erreur. Enfin, si aucune methode 
ne convient, on effectue une nouvelle recherche en tenant compte de l'ellipse. 

Par exemple, en definissant simultanement : 

void f (double x) { } 

void f (Double xObj) { } 

on pourra distinguer convenablement entre un argument de type double et un argument de 
type Double : 

double xl = 8.5 ; Double xOl = 5.25 ; 
f (xl) ; // appel f (double) 
f( xOl) ; // appel f (Double) 

Neanmoins, la distinction entre int et Integer ne sera pas pour autant possible : 

int nl = 2 ; Integer nOl = 5 ; 

f (nl) ; // appel de f (double) apres conversion de int en double 

f (nOl) ; // erreur : pas de conversion implicite de Integer en double ou en Double 

14 Elements de conception des classes 

Voici quelques remarques concemant l'heritage et les interfaces, qui peuvent vous aider dans 
la conception de vos classes. 

14.1 Respect du contrat 

Nous avons deja dit qu'une classe constituait une sorte de contrat defini par les interfaces des 
methodes publiques (signatures et valeur de retour) et leur semantique (leur role). Grace a 
1' encapsulation des donnees, l'utilisateur d'une classe n'a pas a en connaitre l'implementa- 
tion (champs de donnees ou corps des methodes). 

En principe, ce contrat doit etre respecte en cas de derivation. Lorsqu'on surdefinit une 
methode, on s'arrange pour en conserver la semantique. On notera bien qu'a ce niveau, aucun 
outil ne permet actuellement de s' assurer que ce principe est respecte. 
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En general, on a toujours interet a doter une classe derivee d'un constructeur. Meme si ce der- 
nier n'a rien de paiticulier a faire, on se contentera d'un appel d'un constructeur de la classe 
de base. 

14.2 Relations entre classes 

Nous avons deja fait remarquer que 1' heritage creak une relation de type "est". Si T derive de 
T, un objet de type T peut aussi etre considere comme un objet de type T. Cette propriete est 
a la base du polymorphisme. 

Nous avons aussi rencontre un autre type de relation entre objets, a savoir la relation de type 
"a" (appartenance ou composition) correspondant a la situation d'objets membres. Dans ce 
cas, si la classe T comporte un champ de type U, un objet de type Tpossede un champ qui est 
un objet de type U. 

D'autres relations peuvent apparaitre entre les classes, notamment celle d' utilisation. Mais 
les deux precedentes sont les plus importantes. Dans certaines circonstances, il est necessaire 
d'operer avec soin un choix entre elles. Pour illustrer cela, supposez que nous disposions 
d'une classe Point usuelle : 

class Point 
{ 

public void deplace (...){ } 

private int x, y ; 

} 

Pour definir une classe Pointcol, nous pouvons proceder comme nous l'avons fait jusqu'ici en 
mettant en ceuvre une relation "est" : 

class Pointcol extends Point // Pointcol "est" un Point 

{ 

private byte couleur ; 

} 

Dans ce cas, avec : 

Pointcol pc ; 

comme nous l'avons vu, un objet de type Pointcol est un objet de type Point et nous pouvons 
lui appliquer les methodes publiques de Point : 
pc . deplace (...) ; 

Mais nous aurions aussi pu considerer qu'un point colore est forme d'un point et d'une cou- 
leur et definir notre classe Pointcol de cette facon : 

class Pointcol 
{ 

private Point p ; // relation "a" 

private byte couleur ; 

} 

Dans ce cas, toujours avec : 

Pointcol pc ; 
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on voit qu'il n'est plus possible de deplacer le point. II faudrait pour cela pouvoir proceder 
ainsi : 

pc.p.deplace (...) ; // impossible : le champ p est prive 

Meme si Faeces a p etait possible (par exemple si p etait protege ou public), la demarche a 
employer serait differente de la precedente. En effet, il faudrait deplacer le membre p du 
point colore de reference pc et non plus directement le point colore de reference pc. 

Comme on s'en doute, les differences entre les deux types de relation seront encore plus 
criantes si Ton considere les possibilites de polymorphisme. Ces dernieres ne seront exploita- 
bles que dans le premier cas (relation "est"). 

D'une maniere generale, le choix entre les deux types de relation n'est pas toujours aussi 
facile que dans cet exemple. 



Lorsqu'elle n'est pas abstraite, la classe de base fournit des implementations completes de 
methodes. 

Une interface fournit simplement un contrat a respecter sous forme d'en-tetes de methodes. 
La classe implementant l'interface est responsable de leur implementation. Des classes diffe- 
rentes peuvent implementer differemment une meme interface, alors que des classes derivees 
d'une meme classe de base en partagent la meme implementation. 

On dit souvent que Java ne dispose pas de l'heritage multiple mais que ce dernier peut etre avanta- 
geusement remplace par l'utilisation d'interfaces. On voit maintenant que cette affirmation doit 
etre nuancee. En effet, une classe implementant plusieurs interfaces doit fournir du code (et le 
tester !) pour 1' implementation des methodes correspondantes. Les interfaces multiples assurent 
done une aide manifeste a la conception en assurant le respect du contrat. En revanche, elles ne 
simplifient pas le developpement du code, comme le permet l'heritage multiple. 



Java permet de definir ponctuellement une classe, sans lui donner de nom. Cette particularite 
a ete introduite par la version 1.1 pour faciliter la gestion des evenements. Nous la presente- 
rons succinctement ici, en dehors de ce contexte. 



Supposons que Ton dispose d'une classe A. II est possible de creer un objet d'une classe deri- 
vee de A, en utilisant une syntaxe de cette forme : 

A a ; 

a = new A() { // champs et methodes qu' on introduit dans 
//la classe anonyme derivee de A 

} ; 



14.3 Differences entre interface et heritage 



15 Les classes anonymes 



15.1 Exemple de classe anonyme 
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Tout se passe comme si Ton avait procede ainsi : 

A a ; 

class Al extends A { // champs et methodes specifiques a Al 
} ; 



a = new Al ( ) ; 

Cependant, dans ce dernier cas, il serait possible de definir des references de type Al, ce qui 
n'est pas possible dans le premier cas. 

Voici un petit programme illustrant cette possibility. La classe A y est reduite a une seule 
methode affiche. Nous creons une classe anonyme, derivee de A, qui redefinit la methode affi- 
che. 

class A 

{ public void affiche () { System. out. println ("Je suis un A") ; 
} 

} 

public class Anonyml 

{ public static void main (String ] args) 

{ A a ; 

a = new A() { public void affiche () 

{ System. out. println ("Je suis un anonyme derive de A") ; 
} 

} ; 

a.afficheO ; 

} 

} 



Je suis un anonyme derive de A 

Exemple d' utilisation d'une classe anonyme derivee d'une autre 

Notez bien que si A n' avait pas comporte de methode affiche, l'appel a.affichef) aurait ete 
incorrect, compte tenu du type de la reference a (revoyez eventuellement les regies relatives 
au polymorphisme). Cela montre qu'une classe anonyme ne peut pas introduire de nouvelles 
methodes ; notez a ce propos que meme un appel de cette forme serait incorrect : 

( new A() { public void affiche () 

{ System. out. println ("Je suis un anonyme derive de A") ; 
} 

}).affiche() ; 
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15.2Les classes anonymes d'une maniere generale 
15.2.1 II s'agit de classes derivees ou implementant une interface 

La syntaxe de definition d'une classe anonyme ne s'applique que dans deux cas : 

• classe anonyme derivee d'une autre (comme dans l'exemple precedent), 

• classe anonyme implementant une interface. 
Voici un exemple simple de la deuxieme situation : 



interface Affichable 

{ public void afficheO ; 

} 

public class Anonym2 

{ public static void main (String! ] args) 
{ Affichable a ; 

a = new Affichable () 

{ public void affiche () 

{ System. out. println ("Je suis un anonyme implementant Affichable") ; 

} 

} ; 

a. afficheO ; 

} 

} 

Je suis un anonyme implementant Affichable 

Exemple d' utilisation d'une classe anonyme implementant une interface 

15.2.2 Utilisation de la reference a une classe anonyme 

Dans les precedents exemples, la reference de la classe anonyme etait conservee dans une 
variable (d'un type de base ou d'un type interface). On peut aussi la transmettre en argument 
d'une methode ou en valeur de retour.Voyez cet exemple : 

interface I 

{ } 

public class Util 

{ public static f (I i) { } 

} 

f (new I() { // implementation des methodes de I I ) ; 
L'utilisation des classes anonymes conduit generalement a des codes peu lisibles. On la rese- 
rvera a des cas ties paiticulieis ou la definition de la classe anonyme reste breve. 

Nous en rencontrerons quelques exemples dans la definition de classes ecouteurs d'evene- 
ments. 
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Les chaines de caracteres et les 

types enumeres 



Java dispose d'une classe standard nommee String, permettant de manipuler des chaines de 
caracteres, c'est-a-dire des suites de caracteres. Les constantes chaines telles que "bonjour" 
ne sont en fait que des objets de type String construits automatiquement par le compilateur. 

Nous allons etudier les fonctionnalites de cette classe String, qui correspondent a ce que Ton 
attend pour des chaines : longueur, acces aux caracteres d'une chaine par leur position, con- 
catenation, recherche d'occurrences de caracteres ou de sous-chaines, conversions entre 
types primitifs et type String. 

Nous verrons que Java fait preuve d'une certaine originalite en prevoyant que les objets de 
type String ne soient pas modifiables. lis restent cependant utilisables pour creer un nouvel 
objet ; c'est ce qui permettra de realiser des operations de remplacement ou de passage en 
majuscules ou en minuscules. 

Lorsque le programmeur aura besoin de manipuler intensive ment des chaines, il pourra, s'il 
souhaite privilegier l'efficacite de son programme, recourir a une autre classe StringBuffer. 
Contrairement a String, celle-ci autorise la modification directe de son contenu. En revanche, 
nous verrons que les methodes utilisees sont, pour la plupart, differentes de celles de la classe 
String. 

Enfin, nous etudierons les types enumeres introduits par le JDK 5.0. II s'agit de types dans 
lesquels on choisit explicitement les valeurs. 



I Les chalnes de caracteres et les types enumeres 

I Chapitre 9 

1 Fonctionnalites de base de la classe String 

1.1 Introduction 

Comme toute declaration d'une variable objet, l'instruction : 

String ch ; 

declare que ch est destinee a contenir une reference a un objet de type String. 
Par ailleurs, la notation : 

"bonjour" 

designe en fait un objet de type String (ou, pour etre plus precis, sa reference), cree automati- 
quement par le compilateur. Ainsi, avec 

ch = "bonjour" ; 

on aboutit a une situation qu'on peut schematiser ainsi : 



bonjour 



ch I " I 

La classe String dispose de deux constructeurs, l'un sans argument creant une chaine vide, 
1' autre avec un argument de type String qui en cree une copie : 

String chl = new String () ; // chl contient la reference a une chaine vide 
String ch2 = new String ("hello") ; // ch2 contient la reference a une chaine 

/ / contenant la suite "hello" 
String ch3 = new String (ch2) ; // ch3 contient la reference a une chaine 

// copie ole ch2, done contenant "hello" 1 

1 .2 Un objet de type String n'est pas modifiable 

Un objet de type String n'est pas modifiable. II n'existera done aucune methode permettant 
d'en modifier la valeur. Mais il ne faut pas perdre de vue qu'on manipule en fait des referen- 
ces a des objets et que celles-ci peuvent voir leur valeur evoluer au fil du programme. Consi- 
derons ces instructions : 

String chl, ch2, ch ; 
chl = "bonjour" ; 
ch2 = "bonsoir" ; 




1 . II existe bien deux chaines de meme valeur (hello) et non simplement deux references a une meme chaine. 
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Apres leur execution, la situation est la suivante : 



bonjour 



chl 



ch2l 



bonsoir 



Executons maintenant ces instructions : 

ch = chl ; 
chl = ch2 ; 
ch2 = ch ; 

Nous obtenons ceci : 




Les deux objets de type chaine n'ont pas ete modifies, mais les references chl et ch2 Font 
ete. 



1 .3 Entrees-sorties de chames 

Nous avons deja vu qu'on pouvait afficher des constantes chames par la methode println : 

System. out. println ("bonjour") ; 

En fait, cette methode recoit la reference a une chaine. Elle peut done aussi etre utilisee de 
cette maniere : 

String ch ; 



System. out. println (ch) ; 

Nous reviendrons un peu plus loin sur F utilisation du signe + dans F expression fournie a 
println. 

Par ailleurs, comme pour les types primitifs ou les autres types classes, il n'existe pas de 
methode standard permettant de lire une chaine au clavier. C'est pourquoi nous avons dote 
notre classe utilitaire Clavier d'une methode (statique) nommee lireString, comme nous 
Favions fait pour les types primitifs. Voici comment vous pourrez lire une chaine de caracte- 
res quelconques fournis au clavier et obtenir sa reference dans ch (la methode cree automati- 
quement Fobjet de type String necessaire) : 
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String ch ; 



ch = Clavier. lireStringO ; // cree un objet de type String contenant la 

/ / reference a une chaine lue au clavier 



1 .4 Longueur d'une chaine : length 

La methode length permet d'obtenir la longueur d'une chaine, c'est-a-dire le nombre de 
caracteres qu'elle contient (pour etre plus precis, il faudrait parler de la longueur de l'objet 
String dont on lui fournit la reference). 

String ch = "bonjour" ; 

int n = ch. length () ; // n contient 7 

ch = "hello" ; n = ch. length () ; // n contient 5 

ch = " " ; n = ch . length ( ) ; / / n contient 0 

Remarque 

Contrairement a ce qui se passait pour les tableaux ou length designait un champ, nous 
avons bien affaire ici a une methode. Les parentheses a la suite de son nom sont done 
indispensables. 



1 .5 Acces aux caracteres d'une chaine : charAt 

La methode charAt de la classe String permet d'acceder a un caractere de rang donne d'une 
chaine (le premier caractere porte le rang 0). Ainsi, avec : 

String ch = "bonjour" ; 

ch.charAt(O) correspond au caractere 'b', 

ch.charAt(2) correspond au caractere 

Voici un exemple d'un programme qui lit une chaine au clavier et l'affiche verticalement, 
c'est-a-dire a raison d'un caractere par ligne : 

public class MotCol 

{ public static void main (String args[ ] ) 
{ String mot ; 

System. out .print ("donnez un mot : ") ; 
mot = Clavier . lireString () ; 

System. out .println ("voici votre mot en colonne :") ; 

for (int i=0 ; Kmot . length ( ) ; i++) // ou (JDK 5.0) : for (char c : mot) 
System. out. println (mot . charAt (i) ) ; // System. out. println (c) ; 

} // (voir remarque) 
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donnez un mot : Langage 
voici votre mot en colonne 



L 
a 
n 

g 

a 

g 

e 



La boucle dite "for each", introduite par le JDK 5.0, deja evoquee dans les structures de 
controle et les tableaux, peut s'appliquer a une chaine. Par exemple, si mot est une chaine, 
on pourra parcourir ainsi ses differents caracteres : 

for (c : mot) 



Rappelons que cette boucle ne permet que des consultations, et en aucun cas des modi- 
fications. Ici, cela ne constitue pas une contrainte puisqu'un objet de type String n'est, 
de toute facon, pas modifiable. 



1 .6 Concatenation de chaines 



L'operateur + est defini lorsque ses deux operandes sont des chaines. II fournit en resultat une 
nouvelle chaine formee de la concatenation des deux autres, c'est-a-dire contenant successi- 
vement les caracteres de son premier operande, suivis de ceux de son second. Considerons 
ces instructions : 

String chl = "Le langage " ; 
String ch2 = "Java" ; 
String ch = chl + ch2 ; 



Exemple d 'utilisation de la methode charAt 




Remarque 



/ / f aire guelgue chose avec c 
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Elles correspondent a ce schema : 



chl 



Le langage 



ch2i 



Java 



ch 



Le langage Java 



Dorenavant, il existe trois objets de type String dont les references sont dans chl, ch2 et ch. 
Bien entendu, dans une instruction telle que : 

System. out. println (chl + ch2) ; 

revaluation de l'expression chl+ch2 cree un nouvel objet de type String et y place la chaine 
Le langage Java. Apres affichage du resultat, l'objet ainsi cree deviendra candidat au 
ramasse-miettes (aucune reference ne le designe). 

Comme les constantes chaines sont elles-memes des objets de type String, il est possible de 
les utiliser en operande de l'operateur +. Par exemple, avec : 

ch = chl + "C++" ; 

on creera une chaine contenant Le langage C++ et on placera sa reference dans ch. 
Comme l'operateur + est associatif, on peut aussi ecrire des expressions telles que : 

chl + " le plus puissant est : " + ch2 ; 



1 .7 Conversions des operandes de l'operateur + 



Nous venons de voir le role de l'operateur + lorsque ses deux operandes sont de type chaine. 
Nous avons deja vu sa signification lorsque ses deux operandes sont d'un type numerique. 
Mais Java vous autorise egalement a melanger chaines et expressions d'un type primitif. 
Nous avons d'ailleurs deja utilise cette possibility dans des instructions telles que : 

int n = 26 ; 

System. out. println ("n = " + n) ; // affiche : n = 26 

Ce resultat est obtenu par la conversion de la valeur de l'entier n en une chaine. Cette opera- 
tion qui porte aussi le nom de formatage consiste a transformer la valeur codee en binaire (ici 
dans le type int) en une suite de caracteres (chacun de type char) correspondant a la maniere 
de F ecrire dans notre systeme decimal (le cas echeant, on trouvera un signe -). 

Ces formatages s'appliquent aussi aux types flottants (on peut obtenir la lettre E en plus des 
autres caracteres), ainsi qu'aux types booleens (on obtient l'une des deux chaines true ou 
false). 



1 - Fonctionnalites de base de la classe String 



251 



Avec les types flottants, outre les 10 caracteres correspondant a nos chiffres de 0 a 9, ce for- 
matage peut eventuellement contenir un signe -, un point et la lettre E. 

D'une maniere generale, lorsque l'operateur + possede un operande de type String, l'autre est 
converti en chaine. 

Bien entendu, ces possibilites peuvent etre employees en dehors de tout appel a println, par 
exemple : 

int n = 26 ; 

String titre = new String ("resultat : ") ; 
String monnaie = "$" 

String resul = titre + n + " " + monnaie ; 

System. out. println (resul) ; // affichera : resultat : 26 $ 




Informations complementaires 



Lorsque l'un des operandes de + est de type String, l'autre peut etre d'un type primitif, 
mais aussi de n'importe quel type objet. Dans ce cas, il y aura egalement conversion de la 
valeur de F objet en une chaine. Cette conversion est realisee par F appel de la methode 
toString de la classe de Fobjet. Nous avons vu (paragraphe 7.2.1 du chapitre 8) que si 
nous ne redefinissons pas toString, la methode de la classe ancetre Object nous fournit le 
nom de la classe 1 et Fadresse de Fobjet. 



1.8 L'operateur += 

Nous avons deja vu le role de cet operateur dans un contexte numerique. II s' applique ega- 
lement lorsque son premier operande est de type chaine, comme dans : 

String ch = "bonjour" ; 

ch += " monsieur" ; // ch designe la chaine "bonjour monsieur" 

Notez bien que la chaine "bonjour" devient candidate au ramasse-miettes des la fin de l'exe- 
cution de la seconde instruction. 

Voici un autre exemple : 

String ch = "chiffres = " ; 

for (int i = 0 ; i<=9 ; i++) 
ch += i ; 

System. out. println (ch) ; // affiche : chiffres = 0123456789 



1. II est obtenu par 1' appel de la methode getClass, introduite automatiquement dans toute classe. 
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Remarqi 



ues 



1 Notez bien que ces instructions entrainent la creation de 10 chaines intermediaries, de la 
forme : 

chiffres = 
chiffres = 0 
chiffres = 01 



chiffres = 012345678 

Elles deviennent toutes candidates au ramasse-miettes. Seule la derniere est referencee 
par ch : 

chiffres = 0123456789 

Ici, le manque d'efficacite de la demarche est criant. On pourrait utiliser par exemple un 
tableau de caracteres, associe aux possibilites de conversion d'un tel tableau en String, 
comme nous le verrons plus loin. On pourrait egalement recourir a la classe StringBuf- 
fer (presentee plus loin) dont les objets sont effectivement modifiables. 

2 L'operateur += n'est pas defini lorsque son second operande est une chaine, alors que le 
premier n'en est pas une. 



Nous avons vu quelles etaient les differentes facons d'ecrire une constante caractere. Celles- 
ci se generalisent aux constantes chaines. Ainsi, a Finterieur des guillemets, vous pouvez uti- 
liser, en plus des caracteres usuels : 

• la notation speciale, comme dans Vi, V... 

• le code Unicode du caractere, exprime en hexadecimal sous la forme \uxxxx ou xxxx repre- 
sente 4 chiffres hexadecimaux, 

• le code Unicode du caractere, exprime en octal, lorsque sa valeur ne depasse pas 255, sous 
la forme \ooo ou ooo designe trois chiffres entre 0 et 7. 

Parmi ces differentes possibilites, l'utilisation la plus courante est celle du caractere de fin de 
ligne au sein d'une constante chaine. Considerez ces instructions : 

String ch = "bonjour\nmonsieur" ; 
System. out. println (ch) ; 

Elles affichent les deux lignes suivantes : 



Si on s'interesse a ch.lengthf), on obtient 16, qui correspond aux 7 caracteres de bonjour, au 
caractere de fin de ligne (note \n) et aux 8 caracteres de monsieur. 



1 .9 Ecriture des constantes chaines 



bon j our 



monsieur 
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£3[f En C++ 

En C, les chaines de caracteres ne sont rien d' autre que des pointeurs sur des suites 
d'octets. H existe une convention permettant de representer la fin d'une chaine (octet de 
code nul). Dans ces conditions, il n'est pas question d'interdire la modification d'un tel 
emplacement. Qui plus est, meme une constante chaine comme "bonjour" peut acciden- 
tellement voir sa valeur alteree. En C++, la bibliotheque standard fournit un type classe 
nomme String dote de proprietes plus adaptees a la manipulation des chaines. Mais de 
nombreuses fonctions standard (pas seulement celles heritees du C) utilisent les pseudo- 
chaines de base. 

2 Recherche dans une chaine 

La methode indexOf surdefinie dans la classe String permet de rechercher, a partir du debut 
d'une chaine ou d'une position donnee : 

• la premiere occurrence d'un caractere donne, 

• la premiere occurrence d'une autre chaine. 
Dans tous les cas, elle fournit : 

• la position du caractere (ou du debut de la chaine recherchee) si une correspondance a ef- 
fectivement ete trouvee, 

• la valeur -1 sinon. 

II existe egalement une methode lastlndexOf, surdefinie pour effectuer les memes recherches 
que indexOf, mais en examinant la chaine depuis sa fin. 

Voyez ces instructions : 

String mot = "anticonstitutionnellement" ; 
int n ; 

n = mot. indexOf (' t' ) ; // n vaut 2 

n = mot . lastlndexOf (' t' ) ; // n vaut 24 

n = mot. indexOf ("ti") ; // n vaut 2 

n = mot . lastlndexOf ("ti") ; // n vaut 12 

n = mot. indexOf (' x 1 ) ; // n vaut -1 

Voici un exemple de programme complet utilisant (un peu artificiellement) la methode 
indexOf pom compter le nombre de caracteres e presents dans un mot entre au clavier : 

public class Comptel 

{ public static void main (String args! ] ) 
{ final char car = ' e! ; 
int i, posCar ; 
int nbCar = 0 ; 
String ch ; 
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System. out .print ("donnez un mot : ") ; 
ch = Clavier. lireStringO ; 
i = 0 ; 

do 

{ posCar = ch. indexOf (car, i) ; // recherche a partir du caractere de rang i 
if (posCar>=0) { nbCar+t ; 

i = posCar+1 ; 

} 

} 

while (posCar>=0 ) ; 

System. out .println ("votre mot comporte " + nbCar 
+ " fois le caractere " + car) ; 

} 

} 

donnez un mot : exceptionnelle 

votre mot comporte 4 fois le caractere e 

Recherche des e d'un mot avec la methode indexOf 

Bien entendu, ici, il serait aussi simple de proceder de maniere conventionnelle. Le pro- 
gramme suivant fournirait le meme resultat : 

public class Compte2 

{ public static void main (String args[ ] ) 
{ final char car = ' e' ; 
String ch ; 

System. out .print ("donnez un mot : ") ; 
ch = Clavier. lireStringO ; 
int nbCar = 0 ; 

for (int i=0 ; i<ch. length () ; i++) // for (char c : ch) < — depuis JDK 5.0 

if (ch.charAt (i) == car) nbCar++ ; // if (c == car) nbCar+t ; < — 

System. out. println ("votre mot comporte " + nbCar 
+ " fois le caractere " + car) ; 

} 

) 



3 Comparaisons de chaines 

3.1 Les operateurs == et != 

Nous avons deja vu le role de ces operateurs dans le cas d'un objet (c'est-a-dire d'une refe- 
rence a un objet). lis s'appliquent tout naturellement aux chaines puisque celles-ci sont des 
objets. Mais il ne faut pas perdre de vue qu'ils comparent les references fournies comme ope- 
randes (et non les objets references). 

Deux chaines de valeurs differentes ont toujours des references differentes. En revanche, 
deux chaines de meme valeur ne correspondent pas necessairement a un seul et meme objet. 
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En outre, les choses se compliquent du fait que certaines implementations s'arrangent pour 
ne pas creer plusieurs chaines identiques ; en effet, les objets String n'etant pas modifiables, 
une implementation peut tres bien creer un seul exemplaire de deux chaines ayant la meme 
valeur. On parle souvent dans ce cas de fusion des chaines identiques. Mais d'une part cette 
fusion n'est pas obligatoire, d' autre part certaines implementations ne la realisent que dans 
certains cas. 

Informations complementaires 

Si vous voulez savoir comment votre implementation fusionne les chaines identiques, faites 
d'abord ce test simple : 

String chl = "bonjour" ; 
String ch2 = "bonjour" ; 

if (chl == ch2) System. out. println ("egales") ; 

else System. out. println ("differentes") ; 

Si ces chaines apparaissent egales, essayez avec : 

String chl = "bonjour" ; 
String ch2 = "bon" ; 

ch2 += "jour" ; // ch2 reference finalement la chaine "bonjour" 

if (chl == ch2) System. out. println ("egales") ; 

else System . out . println ("differentes") ; 

puis avec : 

String chl = "bonjourl", ch2 ; 

int n = 1 ; 

ch2 = "bonjour"+n ; 

if (chl == ch2) System. out. println ("egales") ; 

else System. out. println ("differentes") ; 



3.2 La methode equals 

Fort heureusement, la classe String dispose d'une methode equals 1 qui compare le contenu 
de deux chaines : 

String chl = "hello" ; 
String ch2 = "bonjour" ; 

chl. equals (ch2) // cette expression est fausse 

chl. equals ("hello") // cette expression est vraie 
La methode equalsIgnoreCase effectue la meme comparaison, mais sans distinguer les 
majuscules des minuscules : 

String chl = "HeLlo" ; 
String ch2 = "hello" ; 



1. II s'agit en fait d'une redefinition de la methode equals, heritee de la super-classe Object. 
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chl.equalsIgnoreCase (ch2) // cette expression est vraie 

chl .equalsIgnoreCase ("hello") // cette expression est vraie 




Precautions 



Les limitations du polymorphisme (voir paragraphe 6.9 du chapitre 8) peuvent se mani- 
fester ici. Considerez : 

Object ol, o2 ; 

String chl = ch2 = " . . . " ; 

ol = chl ; o2 = ch2 ; 

ol. equals (o2) // utilise equals de Object — > comparaison de references 

ol. equals (ch2) // utilise equals de Object — > comparaison de references 

chl. equals (o2) // utilise equals de String — > comparaison de valeurs 

chl. equals (ch2) // utilise equals de String — > comparaison de valeurs 

Cependant, dans les implementations qui fusionnent les chaines identiques, ces quatre 
expressions auront toujours la meme valeur. 



On peut effectuer des comparaisons lexicographiques de chaines pour savoir laquelle de 
deux chaines apparait avant une autre, en se fondant sur l'ordre des caracteres. Toutefois, 
comme on peut s'y attendre, l'ordre des caracteres est celui induit par la valeur de leur code 
(il correspond a celui qui est utilise lorsqu'on applique l'un des operateurs de comparaison a 
des caracteres). En particulier, les majuscules sont separees des minuscules et les caracteres 
accentues apparaissent completement separes des autres. 

La methode compareTo s'utilise ainsi : 

chatnel. compareTof chaine2 ) 

Elle fournit : 

• un entier negatif si chatnel arrive avant chaine2, 

• un entier nul si chatnel et chatnel sont egales (on a alors chatnel .equals(chatne2)), 

• un entier positif si chatnel arrive apres chatnel. 



3.3 La methode compareTo 
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Voici quelques exemples : 



enamel 


chame2 


chamel .compareTo(chame2) 


"bonjour" 


"monsieur" 


negatif 


"bonj" 


"bonjour" 


negatif 


"paris2" 


"parisl 0" 


positif (car '2' > 1') 


"Element" 


"element" 


negatif (car 'E' < 'e') 


"Element" 


"element" 


negatif (car 'E' < 'e') 


"element" 


"element" 


egatif (car 'e' < 'e') 



4 Modification de chatnes 

Les objets de type String ne sont pas modifiables. Mais, la classe String dispose de quelques 
methodes qui, a l'instar de l'operateur +, creent une nouvelle chaine obtenue par transforma- 
tion de la chaine courante. 

Remplacement de caracteres 

La methode replace cree une chaine en remplacant toutes les occurrences d'un caractere 
donne par un autre. Par exemple : 

String ch = "bonjour" ; 

String chl = ch. replace (' o' , ' a' ) ; // ch n' est pas modifiee 

// chl contient "banjaur" 

Extraction de sous-chaine 

La methode substring permet de creer une nouvelle chaine en extrayant de la chaine 
courante : 

• soit tous les caracteres depuis une position donnee, 

String ch = "anticonstitutionnellement" ; 

String chl = ch. substring (5) ; // ch n' est pas modifiee 

// chl contient "onstitutionnellement" 

• soit tous les caracteres compris entre deux positions donnees (la premiere incluse, la secon- 
de exclue) : 

String ch = "anticonstitutionnellement" ; 

String chl = ch. substring (4, 16) ; // ch n' est pas modifiee 

// chl contient "constitution" 

On peut remarquer que 1' instruction : 

String sousCh = ch. substring (n, p) ; 

fournit le meme resultat que : 

String sousCh = "" ; 
for (int i=n ; i<p ; i++) 
sousCh += ch . charAt ( i ) ; 
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Passage en majuscules ou en minuscules 

La methode toLowerCase cree une nouvelle chaine en remplacant toutes les majuscules par 
leur equivalent en minuscules (lorsque celui-ci existe. La methode toUpperCase cree une 
nouvelle chaine en remplacant toutes les minuscules par leur equivalent en majuscules. 

String ch = "LanGaGE_3" ; 

String chl = ch . toLowerCase ( ) ; // ch est inchangee 

// chl contient "langage_3" 

String ch2 = ch . toUpperCase ( ) ; // ch n' est pas modifiee 

// Ch2 contient "LANGAGE_3" 

Suppression des separateurs de debut et de fin 

La methode trim cree une nouvelle chaine en supprimant les eventuels separateurs de debut 
et de fin (espace, tabulations, fin de ligne) : 

String ch = " \n\tdes separateurs avant, pendant\t\n et apres \n\t " ; 
String chl = ch.trim() ; // ch n' est pas modifiee, chl contient la chaine : 

"des separateurs avant, pendant\t\n et apres" 



5 Tableaux de chaines 

On peut former des tableaux avec des elements de n'importe quel type, y compris de type 
classe, done en particulier des tableaux de chaines. Voici un exemple de programme qui 
effectue un tri lexicographique de chaines : 

public class TriCh 

{ public static void main (String args[ ] ) 

{ String tabCh [ ] = { "java", "c", "pascal", "c++", "ada", 
"basic", "fortran" } ; 
String temp ; // pour 1' Echange de deux references 
int i, j ; 

int nbCh = tabCh. length ; 

for (i=0 ; KnbCh-1 ; i++) 
for (j=i ; j<nbCh ; j++) 

if ( (tabCh[ i] . compareTo (tabCh[ j] )) > 0) 
{ temp = tabCh [ i] ; 

tabCh [ i] = tabCh [ j] ; 
tabCh [ j] = temp ; 

} 

System. out. println ("chaines triees : "); 

for (i=0 ; KnbCh ; i++) System. out. println (tabCh[ i] ) ; 

} 

} 

chaines triees : 
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ada 

basic 

c 

C++ 

fortran 

java 

pascal 

Tri d'un tableau de chaines 

Notez qu'ici nous avons pu nous contenter de modifier seulement l'ordre des references des 
chaines, sans avoir besoin de creer de nouveaux objets. 

6 Conversions entre chaines et types primitifs 

Nous avons deja vu comment l'operateur + effectuait un "formatage" en convertissant 
n'importe quel type primitif (ou meme objet) en une chaine. Vous pouvez effectuer directe- 
ment de telles conversions, en utilisant la methode valueOf de la classe String. De plus, il est 
possible, dans certains cas, d'effectuer la conversion d'une chaine en un type primitif, en 
recourant a des methodes des classes enveloppes des types primitifs. 

6.1 Conversion d'un type primitif en une chaine 

Dans la classe String, la methode statique valueOf est surdefinie avec un argument des diffe- 
rents types primitifs. Par exemple, pour le type int : 

int n = 427 ; 

String ch = String. valueOf (n) ; // fournit une chaine obtenue par formatage 

// de la valeur contenue dans n, soit ici "427" 

En fait, 1' affectation ch = String.valueOffn) produit le meme resultat que 1' affectation : 

ch = "" + n ; // utilisation artificielle d' une chaine vide pour pouvoir 

// recourir a 1' operateur + 

Voici un programme qui lit des entiers au clavier et les convertit en chaine (on s'interrompt 
lorsque l'utilisateur fournit un entier nul) : 

public class ConvICh 
( 

public static void main (String args[ ] ) 
{ int n ; 

while (true) // on s' arretera guand n == 0 

{ System. out. print ("donnez un entier (0 pour finir) : ") ; 

n = Clavier. lirelnt () ; 

if (n==0) break ; 

String ch = String. valueOf (n) ; 

System. out. println (" chaine correspondante, de longueur " 
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+ ch. length!) + " : " + ch) 



donnez un entier (0 pour finir) : 427 

chaine correspondante, de longueur 3 : 427 
donnez un entier (0 pour finir) : -4351 

chaine correspondante, de longueur 5 : -4351 
donnez un entier (0 pour finir) : 123456789 

chaine correspondante, de longueur 9 : 123456789 
donnez un entier (0 pour finir) : 0 

Exemples de conversions d'un int en String 
Voici un autre programme qui procede de meme avec des flottants : 

public class ConvDCh 

{ public static void main (String args[ ] ) 
{ double x ; 

while (true) //on s' arretera quand n == 0 
{ System. out. print ("donnez un double (0 pour finir) : ") ; 
x = Clavier. lireDouble () ; 
if (x==0.) break ; 
String ch = String. valueOf (x) ; 

System. out. println (" chaine correspondante, de longueur 
+ ch. length () + " : " + ch) ; 



) 



donnez un double (0 pour finir) : 51 

chaine correspondante, de longueur 4 : 51.0 
donnez un double (0 pour finir) : -23 

chaine correspondante, de longueur 5 : -23.0 
donnez un double (0 pour finir) : 12.345e+2 

chaine correspondante, de longueur 6 : 1234.5 
donnez un double (0 pour finir) : 12.345e30 

chaine correspondante, de longueur 9 : 1.2345E31 
donnez un double (0 pour finir) : 12.345e-30 

chaine correspondante, de longueur 10 : 1.2345E-29 
donnez un double (0 pour finir) : 0 



Exemples de conversions d'un double en String 
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Remarques 

1 La conversion d'un type primitif en une chaine est toujours possible (nous verrons que la 
conversion inverse imposera certaines contraintes a la chaine). Toutefois, avec les deux 
programmes precedents, on peut avoir 1' impression que certaines conversions echouent. 
Par exemple, si Ton entre un entier precede d'un signe + ou d'un espace, on aboutira a un 
arret de 1' execution. En fait, le probleme vient de la methode lirelntf) de la classe Clavier. 
Comme vous l'apprendrez dans le chapitre cons acre aux flux, celles-ci doit d'abord lire 
l'information voulue dans une chaine, avant d'en effectuer une conversion en un type pri- 
mitif (elle utilise la methode que nous decrivons ci-dessous). Dans ces conditions, c'est la 
conversion de chaine en type primitif que realise la methode lirelnt qui provoque une 
exception et que nous traitons en arretant le programme. 

2 La methode value Of peut recevoir un argument de type quelconque, y compris objet. 
Ainsi, si Obj est un objet quelconque, 1' expression : 

String . valueOf (Obj ) 

est equivalente a : 

Obj . toString ( ) 

Comme les types primitifs disposent de classes enveloppes 1 (par exemple Integer pour 
inf), on peut en fait montrer que, par exemple, 1' expression : 

String. valueOf (n) 

est equivalente a : 

Integer (n) . toString () ; 

6.2 Les conversions d'une chaine en un type primitif 

On peut realiser les conversions inverses des precedentes. II faut alors recourir a une methode 
de la classe enveloppe associee au type primitif : Integer pour int ou Float pour float. 

Par exemple, pour convertir une chaine en un entier de type int, on utilisera la methode stati- 
que parselnt de la classe enveloppe Integer, comme ceci : 

String ch = "3587" ; 

int n = Integer .parselnt (ch) ; 

D'une maniere generale, on dispose des methodes suivantes : 

• Byte. parse Byte, 

• Short. parseShort, 

• Integer.parselnt, 



1. La notion de classe enveloppe a ete presentee au paragraphe 13 du chapitre 8. 
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• Long.parseLong, 

• Float, par seFloat, 

• Double. parseDouble. 

Contrairement aux conversions inverses presentees precedemment, celles-ci peuvent ne pas 
aboutir. Ce sera le cas si la chaine contient un caractere invalide pour l'usage qu'on veut en 
faire, par exemple : 

"3." convient pour un float, pas pour un int, 

"34e3" conduira toujours a une erreur, 

Curieusement, le signe + n'est pas accepte par les methodes de conversion en entier, alors 
qu'il Test par les methodes de conversion en flottant. La meme remarque s' applique aux 
separateurs de debut ou de fin (mais, le cas echeant, on peut s'en debarrasser a l'aide de la 
methode trim). 

Lorsque la conversion ne peut aboutir, on obtient une exception NumberFormatException 
qui, si elle n'est pas traitee (comme on apprendra a le faire au chapitre 10), conduit a F arret 
du programme. 

Voici un premier exemple de programme qui lit des chaines au clavier et les convertit en 
entiers (on s'interrompt lorsque l'utilisateur fournit une chaine vide) : 

public class ConvChI 

{ public static void main (String args[ ] ) 
{ String ch ; 

while (true) // on s' arretera quand chaine vide 
{ System. out. print ("donnez une chaine (vide pour finir) : ") ; 
ch = Clavier. lireStringO ; 
if (ch. length ()=0) break ; 
int n = Integer .parselnt (ch) ; 

System. out. println (" entier correspondant " + n) ; 

1 

} 



donnez une chaine (vide pour finir) : 1234 

entier correspondant 1234 

donnez une chaine (vide pour finir) : -789 

entier correspondant -789 

donnez une chaine (vide pour finir) : 0123 

entier correspondant 123 

donnez une chaine (vide pour finir) : 00123456789 

entier correspondant 123456789 

donnez une chaine (vide pour finir) : 



Exemples de conversion a" une chaine en int 
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Voici un autre exemple de programme qui precede de meme avec des valeurs de type 
double : 

public class ConvChD 

{ public static void main (String args! ] ) 
{ String ch ; 

while (true) // on s' arretera quand chaine vide 
{ System. out. print ("donnez une chaine (vide pour finir) : ") ; 
ch = Clavier. lireStringO ; if (ch. length () ==0) break ; 
double x = Double. parseDouble (ch) ; 
System. out. println (" double correspondant " + x) ; 




donnez une chaine (vide pour finir) 

double correspondant 123.0 
donnez une chaine (vide pour finir) 

double correspondant 456.0 
donnez une chaine (vide pour finir) 

double correspondant 1.2345678E24 
donnez une chaine (vide pour finir) 

double correspondant -1234567.89 
donnez une chaine (vide pour finir) 

double correspondant -1.0E-9 
donnez une chaine (vide pour finir) 

Exemples de conversion d'une chaine en double 

\^^~ Remarque 

Les methodes de la classe Clavier emploient la demarche exposee ici pour convertir une 
chaine lue au clavier en une valeur d'un type primitif. 

7 Conversions entre chames et tableaux 
de caracteres 

Nous venons de voir les possibilites de conversion entre chaine et type primitif. Java permet 
egalement d'effectuer des transformations de chaines depuis ou vers un tableau de caracteres. 

On peut construire une chaine a partir d'un tableau de caracteres : 

char mot [ ] = { ' b' , ' d , ' n' , ' j' , ' d , ' u' , ' r 7 } ; // tableau de 7 caracteres 
String ch = new String (mot) ; // ch est construite a partir du tableau mot 

// et contient maintenant la chaine "bonjour" 

II existe meme un constructeur permettant de n'utiliser qu'une partie des caracteres d'un 
tableau (on lui indique la position du premier caractere et le nombre de caracteres) : 



: 123 
: +456 

: 123.45678e22 

: -123456789e-2 

: -.000000001 
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char mot [ ] = { ' t/ , ' o' , ' n' , ' j' , ' o' , ' u' , ' r' } ; // tableau de 7 caracteres 
String ch = new String (mot, 2, 4) ; // ch est construite en prelevant 4 carac 
// du tableau mot, a partir de celui de rang 2 ; ch contient la chaine "onjo" 

De facon symetrique, on peut transformer un objet chaine en un tableau de caracteres, grace a 
la methode toCharArray 1 : 

String ch = "bonjour" ; 
char mot [ ] ; 

mot = ch . toCharArray ( ) ; // mot reference maintenant un tableau de 7 elements 

// (les 7 caracteres de bonjour) 

\^^~ Remarque 

Java permet egalement d'effectuer des conversions entre tableaux d' octets (byte) et chai- 
nes. On peut construire une chaine a partir d'un tableau d'octets ou transformer une partie 
d'une chaine en un tableau d'octets. 

8 Les arguments de la ligne de commande 

Dans tous nos exemples de programmes, Fen-tete de la methode main se presentait ainsi : 

public static void main (String args[ ] ) 

La methode recoit un argument du type tableau de chaines destine a contenir les eventuels 
arguments fournis au programme lors de son lancement. Lorsque le programme est lance a 
partir d'une ligne de commande, ces arguments sont indiques a la suite de l'appel du pro- 
gramme (d'oii l'expression arguments de la ligne de commande). Avec des environnements 
de developpement integre, la demarche est differente. 

On voit qu'il est done facile de recuperer ses arguments dans la methode main. En particulier, 
la longueur du tableau recu indique le nombre d' arguments (le nom du programme n'est pas 
considere comme un argument). Voici un petit programme illustrant cette possibilite, accom- 
pagne de plusieurs executions, supposees lancees ici par une vraie ligne de commande (men- 
tionnee ici en gras) : 

public class ArgMain 

{ public static void main (String args[ ] ) 
{ int nbArgs = args. length ; 

if (nbArgs == 0) System. out. println ("pas oY arguments") ; 
{ for (int i=0 ; KnbArgs ; i++) 

System. out. println ("argument numero " + i+1 + " = " + args[ i] ) ; 

} 

} 

} 



1 . II existe egalement une methode getChars qui permet de definir une position de debut et une longueur. 
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ArgMain 

pas cf arguments 

ArgMain param essai 

argument numero 1 = param 
argument numero 2 = essai 

ArgMain entree.dat sortie 25 

argument numero 1 = entree.dat 
argument numero 2 = sortie 
argument numero 3 = 25 

Exemple de programme recuperant les arguments de la ligne de commande 



Notez bien que les arguments sont toujours recuperes sous forme de chaines. Si Ton sou- 
haite recuperer des informations de type numerique, il faudra proceder a une conversion 
en utilisant les methodes deja rencontrees. 



Les objets de type String ne sont pas modifiables mais nous avons vu qu'il etait possible de 
les employer pour effectuer la plupart des manipulations de chaines. Cependant, la moindre 
modification d'une chaine ne peut se faire qu'en creant une nouvelle chaine (c'est le cas 
d'une simple concatenation). Dans les programmes manipulant intensivement des chaines, la 
perte de temps qui en resulte peut devenir genante. C'est pourquoi Java dispose d'une classe 
StringBuffer destinee elle aussi a la manipulation de chaines, mais dans laquelle les objets 
sont modifiables. 

La classe StringBuffer dispose de fonctionnalites classiques mais elle n'a aucun lien 
d'heritage avec String et ses methodes ne portent pas toujours le meme nom. On peut creer 
un objet de type StringBuffer a partir d'un objet de type String. II existe des methodes : 

• de modification d'un caractere de rang donne : setCharAt, 

• d'acces a un caractere de rang donne : char At, 

• d'ajout d'une chaine en fin : la methode append accepte des arguments de tout type primitif 
et de type String, 

• d'insertion d'une chaine en un emplacement donne : insert, 

• de remplacement d'une partie par une chaine donnee : replace, 

• de conversion de StringBuffer en String : toString. 




Remarqi 



iue 
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Voici un programme utilisant ces differentes possibilites : 

class TstStB 

{ public static void main (String args[ ] ) 
{ String ch = "la java" ; 

StringBuffer chBuf = new StringBuffer (ch) ; 
System. out .println (chBuf) ; 

chBuf . setCharAt (3, 'J); System. out. println (chBuf) ; 

chBuf . setCharAt (1, ' e' ) ; System. out. println (chBuf) ; 
chBuf . append (" 2") ; System. out. println (chBuf) ; 

chBuf . insert (3, "langage ") ; System. out. println (chBuf) ; 

} 

} 

la java 

la Java 

le Java 

le Java 2 

le langage Java 2 

Exemple d' utilisation de la classe StringBuffer 

En outre, la classe StringBuffer dispose de methodes permettant de controler l'emplacement 
memoire alloue a l'objet correspondant. On peut agir sur la taille de l'emplacement soit a la 
creation, soit plus tard en utilisant ensureCapacity, pour eviter des reallocations memoire 
trop frequentes. 

\^^~ Remarque 

Depuis le JDK 5.0, il existe une classe StringBuilder, semblable a StringBuffer, mais dont 
les methodes ne sont pas synchronisees, ce qui les rend plus efficaces lorsque Ton n'est 
pas en presence de plusieurs "threads". Cette notion de synchronisation sera etudiee dans 
le chapitre relatif aux threads. 



10 Les types enumeres (JDK 5.0) 

A Forigine, Java ne disposait pas de ce que Ton nomme generalement des "types enumeres", 
pourtant presents dans bon nombre d'autres langages. Cette lacune a ete comblee par le 
JDK 5.0. II est dorenavant possible de definir en Java un type dont on choisit explicitement 
les identificateurs des constantes. Nous verrons en outre que ce type, implemente sous forme 
d'une classe, dispose d'autres proprietes interessantes comme la possibilite de lui ajouter des 
methodes specifiques. 
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10.1 Definition d'un type enumere 

Depuis le JDK 5.0, Java vous permet de definir ce que Ton nomme classiquement des types 
enumeres (ou encore des "classes d' enumeration"). II s'agit de types dont les valeurs, en 
nombre fini, sont definies par des identificateurs comme dans : 

enum Jour { lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche } 

Ici, les valeurs de ce type nomme Jour sont les 7 constantes notees : lundi, mardi, mercredi, 
jeudi, vendredi, samedi et dimanche. 

On peut alors definir classiquement des objets de type Jour (nous reviendrons bientot sur le 
fait que Jour est effectivement une classe) : 

Jour courant, debut ; 

et leur affecter des valeurs constantes de ce meme type : 

courant = Jour .mercredi ; 
debut = Jour. lundi ; 

On notera que, en toute rigueur, Jour est une classe, bien que le mot-cle class ne figure pas 
dans sa definition (sa presence constituerait une erreur). Les 7 constantes (lundi, mardi, ...) en 
sont des instances (et non des champs) finales, done non modifiables, comme on peut le sou- 
haiter. De plus, tous ces types enumeres, e'est-a-dire toutes ces classes d' enumeration, 
derivent de la classe Enum. 

Par ailleurs, il ne faudra pas oublier de "prefixer" les constantes du type enumere par le nom 
de la classe correspondante. Par exemple, si Ton utilise mardi a la place de Jour.mardi, on 
obtiendra une erreur de compilation. 

10.2Comparaisons de valeurs d'un type enumere 

10.2.1 Comparaisons d'egalite 

On peut comparer par egalite deux valeurs d'un meme type, comme dans : 

if (courant == Jour .dimanche) . . . 

On notera qu'on peut utiliser indifferemment les operateurs == ou equals, bien que le pre- 
mier porte sur l'adresse de l'objet (constant) et le second sur sa valeur car les objets constants 
du type ne sont instancies qu'une seule fois. 

10.2.2 Comparaisons basees sur un ordre 

II n'est pas possible d'utiliser les operateurs arithmetiques usuels sur les types enumeres. En 
revanche, on peut recourir a la methode compareTo (heritee de la classe Enum) qui se fonde 
sur F ordre dans lequel on a declare les constantes. Ainsi, avec : 

courant = Jour .mercredi ; 
courant.compareTo(Jour.mardi) sera positif, 

courant.compareTo(Jour.vendredi) sera negatif, 

courant.compareTo(Jour.mercredi) sera nul. 
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II existe egalement dans la classe Enum, une methode nommee ordinal qui fournit le rang 
d'une valeur donnee dans la liste des constantes du type ; la premiere valeur est de rang 0. 
Ainsi mardi.ordinal() vaut 1. 
Apres 1' affectation : 

courant = mercredi ; 
courant.ordinalf ) vaut 2. 

10.2.3 Exemple recapitulatif 

Voici un petit exemple de programme utilisant les differentes possibilites de comparaison que 
nous venons d'introduire : 

public class EnumComp 

{ public static void main (String args[ ] ) 
{ Jour courant ; 

courant = Jour.mardi ; 

if (courant == Jour .dimanche) System. out. println ("On se repose") ; 

else System. out. println ("On bosse") ; 
if ( courant. equals (Jour. dimanche ) ) System. out. println ("On se repose") ; 

else System. out. println ("On bosse") ; 
if (courant. compareTo (Jour . samedi) < 0) 

System. out .println ("Ce n' est pas encore le week-end") ; 
if ( courant. ordinal () < 5) 

System. out .println ("on est encore en semaine") ; 
System. out. println ("rang du jour dans la semaine (lundi=l) : " 
+ (courant. ordinal () +1) ) ; 

} 

} 

enum Jour { lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche } 

On bosse 
On bosse 

Ce n' est pas encore le week-end 
on est encore en semaine 

rang du jour dans la semaine (lundi=l) : 2 

Exemple d 'utilisation d'un type enumere 

10.3 Utilisation d'un type enumere dans une instruction switch 

II est possible d'utiliser un objet d'un type enumere dans une instruction switch, en 
employant comme etiquettes les valeurs des constantes du type correspondant. En voici un 
exemple : 



public class EnumSwitch 

{ public static void main (String args[ ] ) 
{ Jour courant ; 
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courant = Jour . vendredi ; 
switch (courant) 

{ case lundi : // attention Jour.lundi serait une erreur 

case mardi : 
case mercredi : 

case jeudi : System. out. println ("On bosse") ; 

break ; 

case vendredi : System. out. println ("Bientot le week-end") ; 
break ; 

case samedi : 

case dimanche : System. out. println ("c 1 est le week-end") ; 

} 

} 

} 

enum Jour { lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche } 

Bientot le week-end 

Utilisation d'un type enumere dans une instruction switch 

Notez qu'il est necessaire d'utiliser les noms des constantes sans les prefixer par le nom de 
leur classe. Le compilateur deduit rinformation voulue du type de l'expression mentionnee 
dans 1' instruction switch. 

1 (Deconversions entre chaines et types enumeres 

Une classe d'enumeration dispose, comme toute classe, de la methode toString Celle-ci est 
redefinie dans la classe Enum, de maniere a fournir une chaine correspondant simplement au 
libelle de la constante. Ainsi, avec notre type Jour precedent, l'expression : 

Jour . lundi . toString ( ) 

aura comme valeur la chaine "lundi". 

Pour etre exhaustif, il faut signaler qu'il existe la methode reciproque de toString, fournissant 
l'objet constant d'un type enumere correspondant a un libelle qu'on indique sous forme de 
chaine. Par exemple, l'expression : 

Jour.valueOf ("mardi") 

fournira la reference a l'objet constant Jour.mardi. 

Mais cette methode cree une erreur d' execution lorsque la chaine ne correspond a aucun 
libelle du type. C'est ce qui se produira si Ton ecrit par exemple : 

Jour.valueOf ("Mardi") // Mardi au lieu de mardi — > erreur d' execution 

Cette erreur est ce que Ton nomme une "exception", notion qui sera etudiee ulterieurement. 
Nous verrons qu'il est possible de prevoir du code permettant de la traiter mais cela compli- 
que quelque peu l'emploi de la methode valueOf. 
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10.5 Iteration sur les valeurs d'un type enumere 

II est frequent que Ton ait besoin de parcourir les differentes valeurs d'un type enumere. II 
n'est cependant pas possible d'utiliser la boucle /"or usuelle puisque les operateurs arithmeti- 
ques ne s'appliquent pas a un type enumere. En revanche, on peut recourir a la boucle for... 
each, introduite elle aussi par le JDK 5.0 et que nous avons deja rencontree a plusieurs repri- 
ses. Pour ce faire, il est quand meme necessaire de creer d'abord un tableau des valeurs du 
type, tableau sur lequel on peut ensuite iterer avec la boucle for... each. Ce tableau peut etre 
obtenu a Faide de la methode values de la classe Enum. 

Ainsi, 1' expression 

Jour.values() 

fournit un tableau forme des 7 valeurs du type Jour, exactement comme si nous avions pro- 
cede ainsi : 

Jour[ 0] = Jour . lundi ; Jour[ 1] = Jour . mardi ; ... Jour[ 7] = Jour . dimanche ; 

On peut alors appliquer ainsi la boucle for... each a ce tableau : 

for (Jour j : Jour . values ( ) ) 
/ / faire quelque chose avec j 

Rappelons que les elements represented par j ne sont pas modifiables, ce qui ici ne constitue 
pas une contrainte puisque les constantes d'un type enumeration ne sont pas modifiables. 

Voici un exemple de programme exploitant ces possibilites d' iteration, associees a la 
methode toString, pour afficher les libelles correspondants aux differentes constantes du type 
Jour : 

public class EnumValeurs 

{ public static void main (String args[ ] ) 

{ System. out. println ("Liste des valeurs du type Jour") ; 

for (Jour j : Jour. values () ) 

{ System. out. println (j . toString () ) ; 

1 

} 

} 

enum Jour { lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche } 

Liste des valeurs du type Jour 

lundi 

mardi 

mercredi 

jeudi 

vendredi 

samedi 

dimanche 



Affichage des valeurs d'un type enumere 
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10.6 Lecture des valeurs d'un type enumere 

A priori, vous ne pouvez pas lire au clavier une valeur d'un type enumere, pas plus d'ailleurs 
que vous ne pouviez en afficher la valeur par exemple par println. Mais il vous est toujours 
possible de lire une valeur de type String et de lui associer la valeur corrrespondante du type 
enumere, si elle existe. Nous vous proposons ici un programme qui realise cette "conver- 
sion", en utilisant deux techniques differentes : 

• utilisation de la methode valueOf qui convertit directement une chaine en valeur du type 
enumere, avec les risques deja evoques en cas de non existence, 

• exploration des differentes valeurs du type enumere, jusqu'a trouver la bonne valeur si elle 
existe. 

public class EnumLire 

{ public static void main (String args[ ] ) 
{ String chjour ; 

System. out .print ("Donnez un jour de la semaine : "); 
chJour = Clavier. lireString () ; 

{ 

// premiere demarche : provoque une exception si la valeur de chjour 
// ne represente pas une valeur de type Jour 

Jour courant = Jour.valueOf (chjour) ; 

// ou : Jour courant = Enum.valueOf (chjour) ; 
int numjour = courant . ordinal ( ) ; 

System. out. println ("Methode 1 : " + courant + " est le jour de rang " 
+ numjour) ; 

// deuxieme demarche 
for (Jour j : Jour . values () ) 
{ if (chjour. equals (j .toStringO ) ) 
{ numjour = j . ordinal ( ) ; 

System . out . println ( "Methode 2 : " + courant 

+ " est le jour de rang " + numjour) ; 

} 

} 

} 

} 

} 

enum Jour { lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche } 

Donnez un jour de la semaine : mercredi 
Methode 1 : mercredi est le jour de rang 2 
Methode 2 : mercredi est le jour de rang 2 



Lecture de valeurs d'un type enumere 
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10.7Ajout de methodes et de champs a une classe d'enumeration 

10.7.1 Introduction 

II est possible de definir des methodes specifiques a l'interieur de la classe constitute par un 
type enumere. En voici un premier "cas d'ecole" dans lequel nous ajoutons a notre type Jour, 
une methode nommee affiche qui affiche simplement le nom du jour : 

enum Jour 

{ lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche ; // notez le ";" ici 
public void affiche () 

{ System. out. println (this . toString () ) ; 
} 

} 

Notez la syntaxe un peu particuliere : un point-virgule termine la liste des constantes du type 
et precede les definitions de methodes. La definition de affiche, quant a elle reste classique. 

Voici un petit exemple d' utilisation de ce nouveau type Jour : 

public class EnumMethode 

{ public static void main (String args[ ] ) 

{ System. out .println ("Noms des valeurs du type jour") ; 
for (Jour j : Jour . values ( ) ) j. affiche () ; 

} 

} 

enum Jour 

{ lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche ; 
public void affiche () 

{ System. out .println (this . toString () ) ; 
} 

} 

Noms des valeurs du type jour 

lundi 

mardi 

mercredi 

jeudi 

vendredi 

samedi 

dimanche 



Ajout d'une methode a un type enumere 

Notez qu'il s'agit d'un "cas d'ecole", dans la mesure ou il n'etait pas necessaire de doter 
notre type Jour d'une methode affiche pour en afficher les valeurs. Une banale instruction 
println (j) aurait fait 1' affaire ! 
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10.7.2 Cas particulier des constructeurs 

II est egalement possible de doter une classe d'enumeration d'un ou plusieurs constructeurs. 
Dans ce cas, il faut savoir qu'un tel constructeur est appele au moment de l'instanciation des 
objets constants du type. S'il necessite des arguments, ces derniers doivent etre mentionnes a 
la suite du nom de la constante. 

En voici un exemple dans lequel nous dotons chacun des jours du type Jour d'une abreviation 
(lu pour lundi, ma pour mardi...), fournie a un constructeur a un argument de type String et 
conservee dans un champ nomme abrege. Par ailleurs, une methode nommee abreviation per- 
met de connaitre cette abreviation. 

public class EnumMethodes 

{ public static void main (String args[ ] ) 

{ System. out. println ("Noms des valeurs du type jour et leurs abreviations") ; 
for (Jour j : Jour . values ( ) ) 

System. out. println ( j + " : " + j .abreviation () ) ; 

} 

} 

enum Jour 

{ lundi ("lu"), mardi ("ma"), mercredi ("me"), jeudi ("je"), vendredi ("ve"), 
samedi ("sa"), dimanche ("di") ; 
private Jour (String a) // constructeur ; en argument, 1' abreviation 
{ abrege = a ; 
} 

public String abreviation () { return abrege ; } 
private String abrege ; 

} 

Noms des valeurs du type jour et leurs abreviations 

lundi : lu 

mardi : ma 

mercredi : me 

j eudi : j e 

vendredi : ve 

samedi : sa 

dimanche : di 

Une classe d'enumeration dotee d'un champ, d'une methode et d'un constructeur 
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La gestion des exceptions 



Meme lorsqu'un programme est au point, certaines circonstances exceptionnelles peuvent 
compromettre la poursuite de son execution ; il peut s'agir par exemple de donnees incorrec- 
tes ou de la rencontre d'une fin de fichier prematuree (alors qu'on a besoin d' informations 
supplementaires pour continuer le traitement). 

Bien entendu, on peut toujours essayer d' examiner toutes les situations possibles au sein du 
programme et prendre les decisions qui s'imposent. Mais outre le fait que le concepteur du 
programme risque d'omettre certaines situations, la demarche peut devenir tres vite fasti- 
dieuse et les codes quelque peu complexes. Le programme peut etre rendu quasiment illisible 
si sa tache principale est masquee par de nombreuses instructions de traitement de circons- 
tances exceptionnelles. 

Par ailleurs, dans des programmes relativement importants, il est frequent que le traitement 
d'une anomalie ne puisse pas etre fait par la methode l'ayant detectee, mais seulement par 
une methode ayant provoque son appel. Cette dissociation entre la detection d'une anomalie 
et son traitement peut obliger le concepteur a utiliser des valeurs de retour de methode ser- 
vant de "compte rendu". La encore, le programme peut tres vite devenir complexe ; de plus, 
la demarche ne peut pas s'appliquer a des methodes sans valeur de retour done, en particulier, 
aux constructeurs. 

La situation peut encore empirer lorsque Ton developpe des classes reutilisables destinees a 
etre exploiters par de nombreux programmes. 

Java dispose d'un mecanisme tres souple nomme gestion d' exception, qui permet a la fois : 
• de dissocier la detection d'une anomalie de son traitement, 
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• de separer la gestion des anomalies du reste du code, done de contribuer a la lisibilite des 
programmes. 

D'une maniere generate, une exception est une rupture de sequence declenchee par une ins- 
truction throw comportant une expression de type classe. II y a alors branchement a un 
ensemble d' instructions nomme "gestionnaire d'exception". Le choix du bon gestionnaire est 
fait en fonction du type de Fobjet mentionne a throw (de facon comparable au choix d'une 
fonction surdefinie). 

1 Premier exemple d'exception 

1 .1 Comment declencher une exception avec throw 

Considerons une classe Point, munie d'un constructeur a deux arguments et d'une methode 
affiche. Supposons que Ton ne souhaite manipuler que des points ayant des coordonnees non 
negatives. Nous pouvons, au sein du constructeur, verifier la validite des parametres fournis. 
Lorsque l'un d'entre eux est incorrect, nous "declenchons 1 " une exception a l'aide de l'ins- 
truction throw. A celle-ci, nous devons fournir un objet dont le type servira ulterieurement a 
identifier l'exception concernee. Nous creons done (un peu artificiellement) une classe que 
nous nommerons ErrCoord. Java impose que cette classe derive de la classe standard Excep- 
tion. Pour l'instant, nous n'y placons aucun membre (mais nous le ferons dans d'autres 
exemples) : 

class ErrConst extends Exception 
{ } 

Pour lancer une exception de ce type au sein de notre constructeur, nous fournirons a 1' ins- 
truction throw un objet de type Errconst, par exemple de cette facon : 

throw new ErrConst () ; 

En definitive, le constructeur de notre classe Point peut se presenter ainsi : 

class Point 

{ public Point (int x, int y) throws ErrConst 

{ if ( (x<0) | [ (y<0) ) throw new ErrConst () ; // lance une exception de 
this.x = x ; this.y = y ; // type ErrConst 

} 

Notez la presence de throws ErrConst, dans l'en-tete du constructeur, qui precise que la 
methode est susceptible de declencher une exception de type ErrConst. Cette indication est 
obligatoire en Java, a partir du moment ou l'exception en question n'est pas traitee par la 
methode elle-meme. 

En resume, voici la definition complete de nos classes Point et ErrCoord : 



1. On emploie aussi les verbes "lancer" ou "lever" 
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class Point 

{ public Point (int x, int y) throws ErrConst 
{ if ( (x<0) || (y<0)) throw new ErrConst () ; 
this.x = x ; this.y = y ; 

} 

public void af f iche ( ) 

{ System. out. println ("coordonnees : " + x + " " + y) ; 
} 

private int x, y ; 

} 

class ErrConst extends Exception 
{ } 

Exemple d'une classe Point dont le constructeur declenche une exception ErrConst 

1 .2 Utilisation d'un gestionnaire d'exception 

Disposant de notre classe Point, voyons maintenant comment proceder pour gerer convena- 
blement les eventuelles exceptions de type ErrConst que son emploi peut declencher. Pour ce 
faire, il faut : 

• inclure dans un bloc particulier dit "bloc try" les instructions dans lesquelles on risque de 
voir declenchee une telle exception ; un tel bloc se presente ainsi : 

try 

{ 

// instructions 

} 

• faire suivre ce bloc de la definition des differents gestionnaires d'exception (ici, un seul suf- 
fit). Chaque definition de gestionnaire est precedee d'un en-tete introduit par le mot-cle 
catch (comme si catch etait le nom d'une methode gestionnaire). Voici ce que pourrait etre 
notre unique gestionnaire : 

catch (ErrConst e) 

{ System. out. println ("Erreur construction ") ; 
System. exit (-1) ; 

} 

Ici, il se contente d'afficher un message et d'interrompre l'execution du programme en ap- 
pelant la methode standard System.exit (la valeur de 1' argument est transmis a l'environne- 
ment qui peut eventuellement l'utiliser comme "compte rendu"). 

1 .3 Le programme complet 

A titre indicatif, voici la liste complete de la definition de nos classes, accompagnee d'un 
petit programme de test dans lequel nous provoquons volontairement une exception : 
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class Point 

{ public Point (int x, int y) throws ErrConst 
{ if ( (x<0) || (y<0)) throw new ErrConst () ; 
this.x = x ; this.y = y ; 

} 

public void afficheO 

{ System. out .println ("coordonnees : " + x + " " + y) ; 

} 

private int x, y ; 

} 

class ErrConst extends Exception 
{ } 

public class Exceptl 

{ public static void main (String args[ ] ) 

{ try 

{ Point a = new Point (1, 4) ; 
a . af f iche ( ) ; 
a = new Point (-3, 5) ; 
a. afficheO ; 

} 

catch (ErrConst e) 

{ System. out. println ("Erreur construction ") ; 
System. exit (-1) ; 

} 

} 



coordonnees : 1 4 
Erreur construction 

Premier exemple de gestion d' exception 

Remarque 

Avec certains environnements, la fenetre console disparait des la fin du programme. Pour 
eviter ce desagrement, vous avez probablement pris l'habitude d'ajouter une instruction 
telle que Clavier.lirelntf) a la fin de votre programme. Cette fois ici, cette precaution ne 
suffit plus ; il faut intervenir dans le gestionnaire d'exception en ajoutant une telle instruc- 
tion d'attente, avant l'appel de exit. 

1 .4 Premieres proprietes de la gestion d'exception 

Ce premier exemple etait tres restrictif pour differentes raisons : 

• on n'y declenchait et on n'y traitait qu'un seul type exception ; nous verrons bientot com- 
ment en gerer plusieurs ; 



1 - Premier exemple d'exception 



279 



• le gestionnaire d'exception ne recevait aucune information ; plus exactement, il recevait un 
objet sans valeur qu'il ne cherchait pas a utiliser ; nous verrons comment utiliser cet objet 
pour communiquer une information au gestionnaire ; 

• nous n'exploitions pas les fonctionnalites de la classe Exception dont derive notre classe 
ErrCoord ; 

• le gestionnaire d'exception se contentait d'interrompre le programme ; nous verrons qu'il 
est possible de poursuivre F execution. 

On peut dores et deja noter que le gestionnaire d'exception est defini independamment des 
methodes susceptibles de la declencher. Ainsi, a partir du moment oil la definition d'une 
classe est separee de son utilisation (ce qui est souvent le cas en pratique), il est tout a fait 
possible de prevoir un gestionnaire different d'une utilisation a une autre de la meme classe. 
Dans l'exemple precedent, tel utilisateur peut vouloir afficher un message avant de s'inter- 
rompre, tel autre preferera ne rien afficher ou encore tenter de trouver une solution par 
defaut... 

D' autre part, le bloc try et les gestionnaires associes doivent etre contigus. Cette construction 
est erronee : 

try 

{ 

} 



catch (ErrConst) // erreur : catch doit etre contigu au bloc try 
{ } 

Enfin, dans notre exemple, le bloc try couvre toute la methode main. Ce n'est nullement une 
obligation et il est meme theoriquement possible de placer plusieurs blocs try dans une meme 
methode 1 : 

void true ( ) 
{ 

try { // ici, les exceptions ErrConst sont traitees 

} 

catch (ErrConst) 
{ } 

// ici, elles ne le sont plus 

try { 

} 

catch (ErrConst) 

{ } // ici, elles le sont de nouveau 

// ici, elles ne le sont plus 

} 



1 . Et meme de les imbriquer ! 
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Of 



En C++ 



C++ dispose d'un mecanisme de gestion des exceptions proche de celui de Java. On 
emploie aussi 1' instruction throw dans un bloc try pour declencher une exception qui sera 
traitee par un gestionnaire introduit par catch. Mais on peut lui fournir une expression 
d'un type quelconque (pas necessairement classe). Par ailleurs, il existe une clause throw 
jouant un role comparable a throws. 



2 Gestion de plusieurs exceptions 



Voyons maintenant un exemple plus complet dans lequel on peut declencher et traitor deux 
types d'exceptions. Pour ce faire, nous considerons une classe Point munie : 

• du constructeur precedent, declenchant toujours une exception ErrConst, 

• d'une methode deplace qui s' assure que le deplacement ne conduit pas a une coordonnee 
negative ; si tel est le cas, elle declenche une exception ErrDepl (on cree done, ici encore, 
une classe ErrDepl) : 

public void deplace (int dx, int dy) throws ErrDepl 
{ if ( ((x+dx)<0) || ((y+dy)<0)) throw new ErrDepl ( ) ; 
x += dx ; y += dy ; 

} 

Lors de l'utilisation de notre classe Point, nous pouvons detecter les deux exceptions poten- 
tielles ErrConst et ErrDepl en procedant ainsi (ici, nous nous contentons comme precedem- 
ment d'afficher un message et d'interrompre l'execution) : 

try 

// bloc dans lequel on souhaite detecter les exceptions ErrConst et ErrDepl 

catch (ErrConst e) // gestionnaire de 1' exception ErrConst 

System. out. println ("Erreur construction ") ; 
System. exit (-1) ; 

catch (ErrDepl e) // gestionnaire de 1' exception ErrDepl 

System. out. println ("Erreur deplacement ") ; 
System. exit (-1) ; 

Voici un exemple complet de programme dans lequel nous provoquons volontairement une 
exception ErrDepl ainsi qu'une exception ErrConst : 

class Point 

{ public Point (int x, int y) throws ErrConst 
{ if ( (x<0) || (y<0)) throw new ErrConst () ; 
this.x = x ; this.y = y ; 
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public void deplace (int dx, int dy) throws ErrDepl 
{ if ( ((x+dx)<0) || ((y+dy)<0)) throw new ErrDepl ( ) ; 
x += dx ; y += dy ; 

} 

public void afficheO 

{ System. out. println ("coordonnees : " + x + " " + y) ; 
} 

private int x, y ; 

} 

class ErrConst extends Exception 
{ } 

class ErrDepl extends Exception 
{ } 

public class Except2 

{ public static void main (String args[ ] ) 

{ try 

{ Point a = new Point (1, 4) ; 
a . af f iche ( ) ; 
a. deplace (-3, 5) ; 
a = new Point (-3, 5) ; 
a . af f iche ( ) ; 

} 

catch (ErrConst e) 

{ System. out. println ("Erreur construction ") ; 
System. exit (-1) ; 

} 

catch (ErrDepl e) 

{ System. out. println ("Erreur deplacement ") ; 
System. exit (-1) ; 

} 

} 

} 

coordonnees : 1 4 
Erreur deplacement 

Exemple de gestion de deux exceptions 

Bien entendu, comme la premiere exception {ErrDepl) provoque la sortie du bloc try (et, de 
surcroit, 1' arret de F execution), nous n'avons aucune chance de mettre en evidence celle 
qu'aurait provoquee la tentative de construction d'un point par l'appel new Point(-3, 5). 

Remarque 

La construction suivante serait rejetee par le compilateur : 

public void static main (...) 
{ try 

{ Point a = new Point (2, 5) ; a. deplace (2, 5) ; 
} 
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catch (ErrConst) 

{ 

} 

} 

En effet, des qu'une methode est susceptible de declencher une exception, celle-ci doit 
obligatoirement etre traitee dans la methode ou declaree dans son en-tete (clause 
throws). Ainsi, meme si l'appel de deplace ne pose pas de probleme ici, nous devons 
soit prevoir un gestionnaire pour ErrDepl, soit indiquer throws ErrDepl dans l'en-tete 
de la methode main. Nous reviendrons plus en detail sur ce point. 



3 Transmission d'information au gestionnaire 
d'exception 

On peut transmettre une information au gestionnaire d'exception : 

• par le biais de Fobjet fourni dans 1" instruction throw, 

• par 1' intermediate du constructeur de l'objet exception. 

3.1 Par l'objet fourni a I'instruction throw 

Comme nous l'avons vu, l'objet fourni a I'instruction throw sert a choisir le bon gestionnaire 
d'exception. Mais il est aussi recupere par le gestionnaire d'exception sous la forme d'un 
argument, de sorte qu'on peut l'utiliser pour transmettre une information. II suffit pour cela 
de prevoir les champs appropries dans la classe correspondante (on peut aussi y trouver des 
methodes). 

Voici une adaptation de l'exemple de programme du paragraphe 1, dans lequel nous dotons la 
classe ErrConst de champs abs et ord permettant de transmettre les coordonnees recues par 
le constructeur de Point. Leurs valeurs sont fixees lors de la construction d'un objet de type 
ErrConst et elles sont recuperees directement par le gestionnaire (car les champs ont ete pre- 
vus publics ici, pour simplifier les choses). 



class Point 

{ public Point (int x, int y) throws ErrConst 

{ if ( (x<0) || (y<0)) throw new ErrConst (x, y) ; 
this.x = x ; this.y = y ; 

} 

public void afficheO 

{ System. out. println ("coordonnees : " + x + " " + y) ; 

} 

private int x, y ; 
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class ErrConst extends Exception 
( ErrConst (int abs, int ord) 

{ this. abs = abs ; this. ord = ord ; 

} 

public int abs, ord ; 

} 

public class Exinfol 

{ public static void main (String args[ ] ) 

{ try 

{ Point a = new Point (1, 4) ; 
a . af f iche ( ) ; 
a = new Point (-3, 5) ; 
a . af f iche ( ) ; 

} 

catch (ErrConst e) 

{ System. out. println ("Erreur construction Point") ; 

System. out. println (" coordonnees souhaitees : " + e.abs + " " + e.ord) ; 
System. exit (-1) ; 




coordonnees : 1 4 

Erreur construction Point 

coordonnees souhaitees : -3 5 

Exemple de transmission a" information a un gestionnaire d'exception (1) 

3.2 Par le constructeur de la classe exception 

Dans certains cas, on peut se contenter de transmettre un "message" au gestionnaire, sous 
forme d'une information de type chaine. La methode precedente reste bien sur utilisable, 
mais on peut aussi exploiter une particularite de la classe Exception (dont derive obligatoire- 
ment votre classe). En effet, celle-ci dispose d'un constructeur a un argument de type String 
dont on peut recuperer la valeur a Faide de la methode getMessage (dont heritera votre 
classe). 

Pour beneficier de cette facilite, il suffit de prevoir dans la classe exception, un constructeur a 
un argument de type String, qu'on retransmettra au constructeur de la super-classe Exception. 
Voici une adaptation dans ce sens du programme precedent 

class Point 

{ public Point (int x, int y) throws ErrConst 
{ if ( (x<0) I I (y<0) ) 

throw new ErrConst ( "Erreur construction avec coordonnees " + x + " " + y ) ; 
this.x = x ; this.y = y ; 

} 
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public void afficheO 

{ System. out .println ("coordonnees : " + x + " " + y) ; 

} 

private int x, y ; 

} 

class ErrConst extends Exception 
{ ErrConst (String mes) 

{ super (mes ) ; 

} 

} 

public class Exinfo2 

{ public static void main (String args[ ] ) 

( try 

{ Point a = new Point (1, 4) ; 
a. afficheO ; 
a = new Point (-3, 5) ; 
a . af f iche ( ) ; 

} 

catch (ErrConst e) 

{ System. out. println (e.getMessage () ) ; 
System. exit (-1) ; 

} 

} 



coordonnees : 1 4 

Erreur construction avec coordonnees -3 5 



Exemple de transmission d' information au gestionnaire d' exception (2) 

Remarque 

En pratique, on utilise surtout cette seconde methode de transmission d' information pour 
identifier une exception par un bref message explicatif. Les eventuelles valeurs comple- 
mentaires seront plutot fournies par Fobjet lui-meme, suivant la premiere methode pro- 
posed. 

4 Le mecanisme de gestion des exceptions 

Plusieurs exemples vous ont permis de vous familiariser avec cette nouvelle notion d' excep- 
tion, dans des situations relativement simples. Nous apportons ici un certain nombre de pre- 
cisions concernant : 

• la poursuite de l'execution apres le traitement d'une exception par le gestionnaire, 

• le choix du gestionnaire, 
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• le cheminement des exceptions, c'est-a-dire la maniere dont elles peuvent remonter d'une 
methode a une methode appelante, 

• les regies d'ecriture de la clause throws, 

• les possibilites de redeclencher une exception, 

• 1' existence d'un bloc particulier dit finally. 

4.1 Poursuite de I'execution 

Dans tous les exemples precedents, le gestionnaire d' exception mettait fin a I'execution du 
programme en appelant la methode System.exit. Cela n'est pas une obligation ; en fait, apres 
I'execution des instructions du gestionnaire, I'execution se poursuit simplement avec les ins- 
tructions suivant le bloc try (plus precisement, le dernier bloc catch associe a ce bloc try). 

Observez cet exemple qui utilise les memes classes ErrConst et ErrDepl que l'exemple du 
paragraphe 2 : 

// definition des classes Point, ErrConst et ErrDepl comme dans paragraphe 2 
public class Suitex 

{ public static void main (String args[ ] ) 
{ System. out. println ("avant bloc try") ; 
try 

{ Point a = new Point (1, 4) ; 
a . af f iche ( ) ; 
a.deplace (-3, 5) ; 
a . af f iche ( ) ; 

} 

catch (ErrConst e) 

{ System. out. println ("Erreur construction ") ; 
} 

catch (ErrDepl e) 

{ System. out. println ("Erreur deplacement ") ; 
} 

System. out. println ("apres bloc try") ; 

} 

} 

avant bloc try 
coordonnees : 1 4 
Erreur deplacement 
apres bloc try 

Lorsque V execution se poursuit apres le gestionnaire a" exception 

Ici, le bloc try ne couvre pas toute la methode main. Mais souvent un bloc try couvrira toute 
une methode, de sorte que, apres traitement d'une exception par un gestionnaire ne provo- 
quant pas d' arret, il y aura retour de ladite methode. 
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Un gestionnaire d'exception peut aussi comporter une instruction return. Celle-ci provoque 
la sortie de la methode concernee (et pas seulement la sortie du gestionnaire !). Voyez ce 
schema (on suppose que El est une classe derivee de Exception) : 

int f () 
{ try 

{ 

} 

catch (Exception El e) 
{ 

return 0 ; // OK ; en cas d' exception, on sort de f 

} 

// sans executer ces instructions 

} 




Informations complementaires 



En ce qui concerne la portee des identificateurs, les blocs catch ne sont pas traites comme 
des methodes mais bel et bien comme de simples blocs (on Fa deja constate ci-dessus 
avec le role de return). En theorie, il est possible dans un bloc catch d'acceder a certaines 
variables appartenant a un bloc englobant : 

int f () 

{ int n = 12 ; 
try 

{ float x ; 



} 

catch (Exception El e) 

{ // ici, on n' a pas acces a x (bloc disjoint de celui-ci) 
// mais on a acces a n (bloc englobant) 

} 



4.2 Choix du gestionnaire d'exception 

Lorsqu'une exception est declenchee dans un bloc try, on recherche parmi les differents ges- 
tionnaires associes celui qui correspond a l'objet mentionne a throw. L'examen a lieu dans 
l'ordre ou les gestionnaires apparaissent. On selectionne le premier qui est soit du type exact 
de l'objet, soit d'un type de base (polymorphisme). Cette possibilite peut etre exploitee pour 
regrouper plusieurs exceptions qu'on souhaite traiter plus ou moins finement. Supposons par 
exemple que les exceptions ErrConst et ErrDepl sont derivees d'une meme classe ErrPoint : 

class ErrPoint extends Exception { } 

class ErrConst extends ErrPoint { } 

class ErrDepl extends ErrPoint { } 

Considerons une methode / quelconque (peu importe a quelle classe elle appartient) declen- 
chant des exceptions de type ErrPoint et ErrDepl : 
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void f () 

{ 

throw ErrConst ; 

throw ErrDepl ; 

} 

Dans un programme utilisant la methode/, on peut gerer les exceptions qu'elle est suscepti- 
ble de declencher de cette facon : 

try 

{ //on suppose qu' on utilise f 

} 

catch (ErrPoint e) 

{ // on traite ici a la fois les exceptions de type ErrConst 
// et celles de type ErrDepl 

} 

Mais on peut aussi les gerer ainsi : 



} 

catch (Errconst e) 

{ // on traite ici uniquement les exceptions de type ErrConst 
} 

catch (ErrDepl e) 

{ // et ici, uniquement celles de type ErrDepl 
} 

ou encore ainsi : 

try 

{ //on suppose qu' on utilise f 

} 

catch (Errconst e) 

{ // on traite ici uniquement les exceptions de type ErrConst 
} 

catch (ErrPoint e) 

{ // et ici, toutes celles de type ErrPoint ou derive (autre que Errconst) 
} 



try 



//on suppose qu' on utilise f 




Remarqt 



iue 



Si Ton procedait ainsi : 



try { } 

catch (ErrPoint e) { 
catch (ErrConst e) { 



on obtiendrait une erreur de compilation due a ce que le gestionnaire ErrConst n'a plus 
desormais aucune chance d'etre atteint. 
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Cheminement des exceptions 



Lorsqu'une methode declenche une exception, on cherche tout d'abord un gestionnaire dans 
Feventuel bloc try contenant 1' instruction throw correspondante. Si Ton n'en trouve pas ou si 
aucun bloc try n'est prevu a ce niveau, on poursuit la recherche dans un eventuel bloc try 
associe a F instruction d'appel dans une methode appelante, et ainsi de suite. 

Le gestionnaire est rarement trouve dans la methode qui a declenche F exception puisque Fun 
des objectifs fondamentaux du traitement d' exception est precisement de separer declen- 
chement et traitement ! 

Bien qu'intuitifs, les exemples precedents correspondaient bien a une recherche dans un bloc 
try de F appelant. Par exemple, F exception ErrConst declenchee par un constructeur de Point 
etait traitee non dans un bloc try de ce constructeur, mais dans un bloc try de la methode main 
qui avait appele le constructeur. 



Nous avons deja note sa presence dans Fen-tete de certaines methodes (constructeur de Point, 
methode deplace). D'une maniere generale, Java impose la regie suivante : 



Toute methode susceptible de declencher une exception qu'elle ne traite 
pas localement doit mentionner son type dans une clause throws figu- 
rant dans son en-tete. 



Bien entendu, cette regie concerne les exceptions que la methode peut declencher directe- 
ment par F instruction throw, mais aussi toutes celles que peuvent declencher (sans les traiter) 
toutes les methodes qu'elle appelle. Autrement dit, la clause throws d'une methode doit men- 
tionner au moins la reunion de toutes les exceptions mentionnees dans les clauses throws des 
methodes appelees. 

Grace a cette contrainte, le compilateur est en mesure de detecter tout ecart a la regie. Ainsi, 
au vu de Fen-tete d'une methode, on sait exactement a quelles exceptions on est susceptible 
d'etre confronte. 

On notera que si aucune clause throws ne figure dans Fen-tete de la methode main, on est cer- 
tain que toutes les exceptions sont prises en compte. En revanche, si une clause throws y 
figure, les exceptions mentionnees ne seront pas prises en compte. Comme il n'y a aucun 
bloc try englobant, on aboutit alors a une erreur d' execution precisant F exception concernee. 



Nous verrons un peu plus loin qu'il existe des exceptions dites implicites, qui ne respec- 
tent pas la regie que nous venons d'exposer. Elles pourront provoquer une erreur d' execu- 
tion sans avoir ete declarees dans une clause throws. 



4.4 



La clause throws 



Remarque 
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4.5 Redeclenchement d'une exception 

Dans un gestionnaire d' exception, il est possible de demander que, malgre son traitement, 
l'exception soit retransmise a un niveau englobant, comme si elle n'avait pas ete traitee. II 
suffit pour cela de la relancer en appelant a nouveau F instruction throw : 

try 

{ 

} 

catch (Excep e) // gestionnaire des exceptions de type Excep 
{ 

throw e ; // on relance 1' exception e de type Excep 

} 

Voici un exemple de programme complet illustrant cet aspect : 

class Point 

{ public Point (int x, int y) throws ErrConst 
{ if ( (x<=0) || (y<=0)) throw new ErrConst () ; 
this.x = x ; this.y = y ; 

} 

public void f ( ) throws ErrConst 
( try 

{ Point p = new Point (-3, 2) ; 
} 

catch (ErrConst e) 

{ System. out. println ("dans catch (ErrConst) de f") ; 

throw e ; // on repasse 1' exception a un niveau superieur 

} 

} 

private int x, y ; 



class ErrConst extends Exception 
{ } 

public class Redecl 

{ public static void main (String args[ ] ) 

{ try 

{ Point a = new Point (1, 4) ; 
a.f() ; 

} 

catch (ErrConst e) 

{ System. out. println ("dans catch (ErrConst) de main") ; 
} 

System. out. println ("apres bloc try main") ; 
} 
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dans catch (ErrConst) de f 
dans catch (ErrConst) de main 
apres bloc try main 

Exemple de redeclenchement d'une exception 

Cette possibility de redeclenchement d'une exception s'avere tres precieuse lorsque Ton ne 
peut resoudre localement qu'une partie du probleme pose. 




Informations complementaires 



Une exception peut en declencher une autre. Cette situation est tout a fait legale, meme si 
elle est rarement utilisee. 

try { } 

catch (Exl e) // gestionnaire des exceptions de type Exl 

{ 

throw new Ex2() ; //on lance une exception de type Ex2 

} 

Voici un exemple d'ecole : 

class Point 

{ public Point (int x, int y) throws ErrConst 
{ if ( (x<=0) || (y<=0) ) throw new ErrConst () ; 
this.x = x ; this.y = y ; 

} 

public void f() throws ErrConst, ErrBidon 
{ try 

{ Point p = new Point (-3, 2) ; 
} 

catch (ErrConst e) 

{ System. out. println ("dans catch (ErrConst) de f") ; 

throw new ErrBidon () ; //on lance une nouvelle exception 

} 

} 

private int x, y ; 

} 

class ErrConst extends Exception 
{ } 

class ErrBidon extends Exception 
{} 

public class Redecll 

{ public static void main (String args[ ] ) 

{ try 

{ Point a = new Point (1, 4) ; 
a.f() ; 

} 
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catch (ErrConst e) 

{ System. out. println ("dans catch (ErrConst) de main") ; 
} 

catch (ErrBidon e) 

{ System. out. println ("dans catch (ErrBidon) de main") ; 
} 

System. out. println ("apres bloc try main") ; 

} 

} 

dans catch (ErrConst) de f 
dans catch (ErrBidon) de main 
apres bloc try main 

Exemple de gestionnaire declenchant une nouvelle exception 

|3fr En C++ 

On peut relancer une exception par l'instruction throw (sans parametres). Mais il s'agit 
obligatoirement d'une exception de meme type quelle celle traitee par le gestionnaire. 

4.6 Le bloc finally 

Nous avons vu que le declenchement d'une exception provoque un branchement incondition- 
nel au gestionnaire, a quelque niveau qu'il se trouve. L' execution se poursuit avec les instruc- 
tions suivant ce gestionnaire. 

Cependant, Java permet d'introduire, a la suite d'un bloc try, un bloc particulier destruc- 
tions qui seront toujours executees : 

• soit apres la fin "naturelle" du bloc try, si aucune exception n'a ete declenchee (il peut s'agir 
d'une instruction de branchement inconditionnel telle que break ou continue), 

• soit apres le gestionnaire d' exception (a condition, bien sur, que ce dernier n'ait pas provo- 
que d'arret de F execution). 

Ce bloc est introduit par le mot-cle finally et doit obligatoirement etre place apres le dernier 
gestionnaire. 

Bien entendu, cette possibilite n'a aucun interet lorsque les exceptions sont traitees locale- 
ment. Considerez par exemple : 

try { } 

catch (Ex e) { } 

finally 

{ // instructions A 
} 

Ici, le meme resultat pourrait etre obtenu en supprimant tout simplement le mot-cle finally et 
en conservant les instructions A (avec ou sans bloc) a la suite du gestionnaire. 
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En revanche, il n'en va plus de meme dans : 

void f (...) throws Ex 
{ 

try 

{ } 

finally 

{ // instructions A } 

} 

Ici, si une exception Ex se produit dans /, on executera les instructions A du bloc finally avant 
de se brancher au gestionnaire approprie. Sans la presence de finally, ces memes instructions 
ne seraient executees qu'en F absence d' exception dans le bloc try. 

D'une maniere generale, le bloc finally peut s'averer precieux dans le cadre de ce que Ton 
nomme souvent Y acquisition de ressources. On range sous ce terme toute action qui 
necessite une action contraire pour la bonne poursuite des operations : la creation d'un objet, 
l'ouverture d'un fichier, le verrouillage d'un fichier partage... Toute ressource acquise dans 
un programme doit pouvoir etre convenablement liberee, meme en cas d' exception. Le bloc 
finally permet de traiter le probleme puisqu'il suffit d'y placer les instructions de liberation de 
toute ressource allouee dans le bloc try. 

Remarque 

En toute rigueur, il est possible d'associer un bloc finally a un bloc try ne comportant 
aucun gestionnaire d' exception. Dans ce cas, ce bloc est execute apres la sortie du bloc 
try, quelle que soit la facon dont elle a eu lieu : 

try 

{ 

if (...) break ; // si ce break est execute, on executera d' abord 

} 

finally // ce bloc finally 

{ } 

// avant de passer a cette instruction 

Informations complementaires 

En theorie, il est possible de rencontrer des instructions return a la fois dans un bloc try et 
dans un bloc finally, comme dans : 

try 

{ 

return 0 ; // provoque d' abord 1' execution 

} 

finally // de ce bloc finally 

{ 

return -1 ; // et un retour avec la valeur -1 

} 
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Ici, la methode semble devoir executer une instruction return 0, mais il lui faut quand 
meme executer le bloc finally, qui contient a son tour une instruction return -1. Dans ce 
cas, c'est la valeur prevue en dernier qui sera renvoyee (ici -1). 

5 Les exceptions standard 

Java fournit de nombreuses classes predefinies derivees de la classe Exception, qui sont utili- 
sees par certaines methodes standard ; par exemple, la classe IOException et ses derivees sont 
utilisees par les methodes d' entrees-sorties. Certaines classes exception sont meme utilisees 
par la machine virtuelle a la rencontre de situations anormales telles qu'un indice de tableau 
hors limites, une taille de tableau negative... 

Ces exceptions standard se classent en deux categories. 

• Les exceptions explicites (on dit aussi sous controle) correspondent a ce que nous venons 
d'etudier. Elles doivent etre traitees par une methode, ou bien etre mentionnees dans la clau- 
se throws. 

• Les exceptions implicites (ou hors controle) n'ont pas a etre mentionnees dans une clause 
throw et on n'est pas oblige de les traiter (mais on peut quand meme le faire). 

En fait, cette classification separe les exceptions susceptibles de se produire n'importe oil 
dans le code de celles dont on peut distinguer les sources potentielles. Par exemple, un 
debordement d' indice ou une division entiere par zero peuvent se produire presque partout 
dans un programme ; ce n'est pas le cas d'une erreur de lecture, qui ne peut survenir que si 
Ton fait appel a des methodes bien precises. 

Vous trouverez la liste des exceptions standard en annexe D 1 . Voici un exemple de 
programme qui detecte les exceptions standard NegativeArraySizeException et 
ArraylndexOutOfBoundsException et qui utilise la methode getMessage pour afficher le 
message correspondant 2 . II est accompagne de deux exemples d'execution. 

public class ExcStdl 

{ public static void main (String args[ ] ) 
{ try 

{ int t[ ] ; 

System. out. print ("taille voulue : ") ; 
int n = Clavier . lirelnt () ; 
t = new int[ n] ; 

System. out. print ("indice : ") ; 

int i = Clavier. lirelnt () ; t[ i] = 12 ; 

System. out. println ("*** fin normale") ; 

} 



1 . Vous y verrez qu'il existe de nombreuses exceptions implicites et qu'il serait done fastidieux de devoir toutes 
les traiter ou les declarer. 

2. Notez qu'il n'est guere explicite ! 
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catch (NegativeArraySizeException e) 

{ System. out .println ("Exception taille tableau negative : " 
+ e.getMessage () ) ; 

} 

catch (ArraylndexOutOfBoundsException e) 

{ System. out. println ("Exception indice tableau : " + e.getMessage () ) ; 
} 

} 

} 

taille voulue : -2 

Exception taille tableau negative : 

taille voulue : 10 
indice : 15 

Exception indice tableau : 15 

Exemple de traitement d 'exceptions standard 

Remarque 

Nous pourrions ecrire le programme precedent sans detection d' exceptions (une telle ver- 
sion figure parmi les fichiers source disponibles en telechargement sur www.editions- 
eyrolles.com sous le nom ExcStd2.java). Comme les exceptions concernees sont implici- 
tes, il n'est pas necessaire de les declarer dans throws. Dans ce cas, les deux exemples 
d'execution conduiraient a un message d'erreur et a l'abandon du programme. 

Informations complementaires 

La classe Exception derive en fait de Throwable. II existe une classe Error, derivee de 
Throwable (et sans lien avec Exception), qui correspond a des exceptions particulieres (on 
parle parfois d'erreurs plutot que d' exceptions) que vous n'aurez generalement pas a trai- 
ter 1 . 




1 . Pour vous en convaincre, voici des exemples de telles exceptions : VirtualMachineError, LinkageError, 
InstantiationError, InternalError. 
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Les threads 



Actuellement, toutes les machines, qu'elles soient monoprocesseur ou multiprocesseur, per- 
mettent d'executer plus ou moins simultanement plusieurs programmes (on parle encore de 
taches ou de processus). Sur les machines monoprocesseur, la simultaneite, lorsqu'elle se 
manifeste, n'est en fait qu'une illusion : a un instant donne, un seul programme utilise les res- 
sources de 1' unite centrale ; mais Fenvironnement "passe la main" d'un programme a un 
autre a des intervalles de temps suffisamment courts pour donner F impression de la 
simultaneite ; ou encore, Fenvironnement profite de Fattente d'un programme (entree utilisa- 
teur, lecture ou ecriture sur disque, attente de fin de transfert d'un fichier Web...) pour donner 
la main a un autre. 

Java presente Foriginalite d'appliquer cette possibility de multiprogrammation au sein d'un 
meme programme dont on dit alors qu'il est forme de plusieurs threads independants. Le 
controle de l'execution de ces differents threads (c'est-a-dire la facon dont la main passe de 
Fun a Fautre) se fera alors, au moins partiellement, au niveau du programme lui-meme et ces 
threads pourront facilement communiquer entre eux et partager des donnees. 

Nous commencerons par vous montrer qu'il existe deux facons de creer des threads : soit en 
exploitant la classe predefinie Thread, soit en creant une classe specifique implementant 
Finterface Runnable. Puis nous verrons comment interrompre un thread depuis un autre 
thread, ce qui nous amenera a parler des threads demons. Nous apprendrons ensuite a coor- 
donner les actions de plusieurs threads, d'une part en definissant des methodes dites synchro- 
nisers, d' autre part en gerant des attentes faisant intervenir la notion de verrou sur un objet. 
Nous passerons alors en revue les differents etats d'un thread. Enfin, nous verrons comment 
agir sur la priori te d'un thread. 
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1 Exemple introductif 

Voici un programme qui va lancer trois threads simples, chacun d'entre eux se contentant 
d'afficher un certain nombre de fois un texte donne, a savoir : 

• 10 fois "bonjour" pour le premier thread, 

• 12 fois "bonsoir" pour le deuxieme thread, 

• 5 fois un changement de ligne pour le troisieme thread. 

En Java, un thread est un objet d'une classe qui dispose d'une methode nommee run qui sera 
executee lorsque le thread sera demarre. II existe deux facons de definir une telle classe. La 
plus simple, que nous utiliserons ici, consiste a creer une classe derivee de la classe Thread 
(1' autre facon sera etudiee un peu plus loin ; elle s'averera utile lorsque la classe du thread 
sera deja derivee d'une autre classe). 

Ici, nos trois threads pourront etre crees a partir d'une seule classe, a condition de fournir au 
constructeur les informations caracterisant chaque thread (texte, nombre d'affichages). Cette 
classe que nous nommerons Ecrit pourra se presenter ainsi : 

class Ecrit extends Thread 
{ public Ecrit (String texte, int nb) 
{ this. texte = texte ; 
this.nb = nb ; 

} 

public void run () 

{ for (int i=0 ; i<nb ; 

System. out. print (texte) ; 

} 

La creation des objets threads pourra se faire, depuis n'importe quel endroit du programme 
(par exemple depuis une methode main) de cette facon : 

Ecrit el = new Ecrit ("bonjour", 10) ; 
Ecrit e2 = new Ecrit ("bonsoir", 12) ; 
Ecrit e3 = new Ecrit ("\n", 5) ; 

Ces appels ne font cependant rien d'autre que de creer des objets. Le lancement de l'execu- 
tion du thread se fait en appelant la methode start de la classe Thread, par exemple : 

el. start () ; // lance 1' execution du thread el 

Cet appel realise les operations necessaires pour qu'un nouveau thread soit bien pris en 
compte a la fois par la "machine virtuelle Java" et par le systeme d'exploitation, puis lance 
l'execution de la methode run de l'objet correspondant. 

Cependant, si nous nous contentons de cela, nous ne sommes pas certains que nos threads 
s'executent en apparente simultaneity, autrement dit que les textes apparaissent plus ou 
moins entremeles a l'ecran. Plus precisement, comme nous le verrons plus loin, ce point 
depend de l'environnement utilise. Aussi, est-il recommande de faire en sorte que la methode 
run d'un thread s'interrompe de temps en temps. II existe plusieurs facons de provoquer cette 
interruption, chacune pouvant etre prise en compte de maniere differente par le mecanisme 
de gestion des threads. Ici, nous utiliserons 1' appel sleep (t) out est un nombre de millisecon- 
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des. Cet appel demande que le thread correspondant soit arrete (on dira "mis en sommeil") 
pour au moins la duree mentionnee. Cette demarche laisse ainsi la possibility a d'autres 
threads de s'executer a leur tour. 

La methode sleep est susceptible de generer une exception de type InterruptedException dont 
nous verrons plus tard Finteret. Pour 1' instant, nous nous contenterons de l'intercepter en 
mettant fin a la methode run. 

Si nous prevoyons de faire du temps de sommeil de chaque thread, un troisieme argument de 
son constructeur, voici ce que pourrait etre notre programme : 



public class TstThrl 

{ public static void main (String args! ] ) 

{ Ecrit el = new Ecrit ("bonjour ", 10, 5) ; 
Ecrit e2 = new Ecrit ("bonsoir ", 12, 10) ; 
Ecrit e3 = new Ecrit ("\n", 5, 15) ; 
el. start () ; 
e2. start () ; 
e3. start () ; 

} 

} 

class Ecrit extends Thread 

{ public Ecrit (String texte, int nb, long attente) 
{ this. texte = texte ; this.nb = nb ; 
this. attente = attente ; 

} 

public void run () 
( try 

{ for (int i=0 ; i<nb ; i++) 
{ System. out. print (texte) ; 
sleep (attente) ; 

} 

} 

catch (InterruptedException e) {} // impose par sleep 

} 

private String texte ; 
private int nb ; 
private long attente ; 
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1 Un programme comporte toujours au moins un thread dit "thread principal" correspon- 
dant tout simplement a la methode main. Ici, notre programme comporte done quatre 
threads et non trois. Lorsque la methode sleep est appelee, elle permet de donner la main 
a Fun des autres threads, y compris le thread principal (qui cependant, ici, n'a plus rien a 
faire). 

2 Si Ton appelait directement la methode run de nos objets threads, le programme fonc- 
tionnerait mais Ton n'aurait plus affaire a trois threads differents. On executerait alors 
entierement la methode run du premier, puis celle du deuxieme et enfin celle du troi- 
sieme, tout cela dans un seul thread. Les appels de sleep autoriseraient l'environnement 
a executer eventuellement d' autres threads que celui-ci, ce qui ne ferait que ralentir 
l'execution de l'ensemble de notre programme. 

3 La methode start ne peut etre appelee qu'une seule fois pour un objet thread donne. 
Dans le cas contraire, on obtiendra une exception IllegalThreadStateException. 

4 La methode sleep est en fait une methode statique (de la classe Thread ) qui met en 
sommeil le thread en cours d'execution. Nous aurions pu remplacer l'appel sleep 
(attente) par Thread. sleep (attente). 

5 Si nous ne prevoyons pas d'appel de sleep dans notre methode run, le programme fonc- 
tionnera encore mais son comportement dependra de l'environnement. Dans certains 
cas, on pourra voir chaque thread s' executer integralement avant que le suivant 
n'obtienne la main. 



Nous venons de voir comment creer des threads a partir de la classe Thread. Cette demarche 
est simple mais elle presente une lacune : les objets threads ne peuvent pas deriver d'autre 
chose que de Thread (puisque Java ne possede pas d'heritage multiple). En fait, pour creer 
des threads, vous disposez d'une seconde demarche basee non plus sur une classe derivee de 
Thread, mais simplement sur une classe implementant Finterface Runnable 1 , laquelle com- 
porte une seule methode nommee run. 

Si nous cherchons a appliquer cette demarche a notre exemple precedent, nous allons etre 
amenes a creer une classe (nous la nommerons toujours Ecrit) se presentant ainsi : 

class Ecrit implements Runnable 

{ public Ecrit (String texte, int nb, long attente) 
{ / / memes instructions que precedemment 



2 Utilisation de I'interface Runnable 



1. La classe Thread implemente bien I'interface Runnable. 
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public void run () 

{ // meme contenu que precedemment 

// en n' oubliant pas que sleep est statique : 1' appel sera : 

// Thread. sleep (t) ; 

} 

} 

Nous serons amenes a creer des objets de type Ecrit, par exemple : 

Ecrit el = new Ecrit ("bonjour ", 10, 5) ; 

Cette fois, ces objets ne sont plus des threads et ne peuvent done plus etre lances par la 
methode start. Nous devrons tout d'abord creer des objets de type Thread en utilisant une 
forme particuliere de constructeur recevant en argument un objet implementant I'interface 
Runnable, par exemple : 

Thread tl = new Thread (el) ; // cree un objet thread associe a 1' objet el 

// qui doit implementer 1' interface Runnable 
// pour disposer d une methode run 

Nous lancerons ensuite classiquement ce thread par start : 

tl. start () ; 

En definitive, voici comment nous pouvons transformer 1' exemple precedent : 



public class TstThr3 

{ public static void main (String args[ ] ) 

{ Ecrit el = new Ecrit ("bonjour ", 10, 5) ; 
Ecrit e2 = new Ecrit ("bonsoir ", 12, 10) ; 
Ecrit e3 = new Ecrit ("\n", 5, 15) ; 
Thread tl = new Thread (el) ; tl. start () ; 
Thread t2 = new Thread (e2) ; t2. start () ; 
Thread t3 = new Thread (e3) ; t3. start () ; 

} 

} 

class Ecrit implements Runnable 

{ public Ecrit (String texte, int nb, long attente) 
{ this. texte = texte ; 
this.nb = nb ; 
this. attente = attente ; 

} 

public void run () 
( try 

{ for (int i=0 ; i<nb ; i++) 
{ System . out . print (texte) ; 

Thread. sleep (attente) ; // attention Thread. sleep 

} 

} 

catch (InterruptedException e) { } // impose par sleep 

} 

private String texte ; 
private int nb ; 
private long attente ; 
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bonsoir 

bonsoir bonsoir 



bonsoir 

bonsoir bonsoir 



Exemple de programme langant trois threads, objets d'une classe implementant 

V interface Runnable 

Remarques 

1 Dans la pratique, la classe permettant de creer les objets destines a etre transmis au cons- 
tructeur de la classe Thread derivera d'une autre classe (ce qui n'est pas le cas ici). C'est 
d'ailleurs cette propriete qui vous obligera a recourir a la presente demarche. 

2 Rien ne vous empeche de doter votre classe Ecrit d'une methode nommee start jouant 
alors un double role : creation de l'objet de type Thread et lancement du thread. Vous 
retrouverez alors un formalisme tres proche de celui presente dans le paragraphe 
precedent : 

public class TstThr2 

{ public static void main (String args[ ] ) 

{ Ecrit el = new Ecrit ("bonjour ", 10, 5) ; 
Ecrit e2 = new Ecrit ("bonsoir ", 12, 10) ; 
Ecrit e3 = new Ecrit ("\n", 5, 15) ; 
el. start () ; 
e2. start () ; 
e3 . start ( ) ; 

} 

} 

class Ecrit implements Runnable 

{ public Ecrit (String texte, int nb, long attente) 
{ // constructeur inchange 
} 

public void start () 
{ Thread t = new Thread (this) ; 
t. start () ; 

} 

public void run () 

{ // methode run inchangee 

} 



Le programme complet figure parmi les fichiers source disponibles en telechargement 
sur www.editions-eyrolles.com sous le nom TstThr2.java. 
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3 Interruption d'un thread 

3.1 Demarche usuelle d'interruption par un autre thread 

Dans les exemples precedents, les threads s'achevaient tout naturellement avec la fin de 
l'execution de leur methode run (qui se produisait apres un nombre determine d'appels de 
sleep). Dans certains cas, on peut avoir besoin d'interrompre prematurement un thread depuis 
un autre thread. Ce besoin peut devenir fondamental dans le cas de ce que nous nommerons 
des "threads infinis", c'est-a-dire dans lesquels la methode run n'a pas de fin programmee ; 
ce pourrait etre le cas d'un thread de surveillance d'appels dans un serveur Web. 

Java dispose d'un mecanisme permettant a un thread d'en interrompre un autre. La methode 
interrupt de la classe Thread demande a l'environnement de positionner un indicateur signa- 
lant une demande d'arret du thread concerne (attention, l'appel n'interrompt pas directement 
le thread). 

Par ailleurs, dans un thread, il est possible de connaitre l'etat de cet indicateur a l'aide de la 
methode statique interrupted (il existe egalement islnterrupted ; nous y reviendrons par la 
suite). Ce schema recapitule la situation : 

Thread 1 Thread 2 nomme t 

t . interrupt ( ) ; // positionne un run 

// indicateur dans t { 

if (interrupted) 

{ 

return ; // fin du thread 

} 

} 

Notez bien que l'arret effectif du thread t reste sous sa propre responsabilite. Rien n'empeche 
(hormis le bon sens) de faire autre chose que return, voire meme d'ignorer cette demande 
d'arret. D'autre part, il est necessaire que le test de 1' indicateur se fasse regulierement dans la 
methode run et non simplement au debut de son execution. 

Ce schema s'avere generalement incomplet car certaines methodes comme sleep (ainsi que 
wait que nous rencontrerons plus tard) examinent elles-aussi cet indicateur et declenchent 
une exception InterruptedException s'il est positionne. II est done necessaire de traiter cette 
exception d'une maniere compatible avec ce qui est fait dans la methode run elle-meme. 

Exemple 

Voici une adaptation de l'exemple du paragraphe 1 qui lancait trois threads. Mais cette fois, 
les threads sont "infinis", c'est-a-dire que chacun affiche indefiniment son texte. Nous pre- 
voyons que le thread principal (main) puisse interrompre chacun des trois autres threads : le 
premier, apres que l'utilisateur ait frappe et valide un premier texte (eventuellement vide), les 
deux derniers apres qu'il ait frappe et valide un second texte. Ici, nous avons frappe successi- 
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vement les textes "w" et "x", lesquels s'entremelent tout naturellement avec les affichages des 
trois threads. 

Ici, nous testons tout naturellement l'indicateur d' interruption avant chaque affichage. 

public class Tstlnter 

{ public static void main (String args[ ] ) 
{ Ecrit el = new Ecrit ("bonjour ", 5) ; 
Ecrit e2 = new Ecrit ("bonsoir ", 10) ; 
Ecrit e3 = new Ecrit ("\n", 35) ; 
el. start () ; 
e2. start () ; 
e3 . start ( ) ; 

Clavier . lireString ( ) ; 

el . interrupt () ; // interruption premier thread 

System. out .println ("\n*** Arret premier thread***") ; 
Clavier . lireString ( ) ; 

e2 . interrupt ( ) ; // interruption deuxieme thread 

e3. interrupt () ; // interruption troisieme thread 

System. out .println ("\n*** Arret deux derniers threads ***") ; 

} 

} 

class Ecrit extends Thread 
{ public Ecrit (String texte, long attente) 
{ this. texte = texte ; 
this. attente = attente ; 

} 

public void run () 
{ try 

{ while (true) // boucle infinie 

{ if (interrupted () ) return ; 
System. out. print (texte) ; 
sleep (attente) ; 

} 

} 

catch ( InterruptedException e) 

{ return ; //on peut omettre return ici 

} 

} 

private String texte ; 
private long attente ; 

} 



bonjour bonsoir bonjour bonsoir 
bonjour bonsoir bonjour bonjour bonsoir 
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bonjour bonsoir bonjour bonsoir wbonjour 
bonjour bonsoir 

*** Arret premier thread *** 

bonsoir bonsoir bonsoir 

bonsoir bonsoir 

bonsoir bonsoir 

bonsoir bonsoir 

xbonsoir bonsoir 

bonsoir bonsoir 

bonsoir 

*** Arret deux derniers threads *** 
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Informations complementaires 

La methode statique interrupted de la classe Thread remet a false l'indicateur de demande 
d' arret. Par ailleurs, la classe Thread dispose egalement d'une methode (non statique, 
cette fois) islnterrupted qui examine l'indicateur de l'objet thread correspondant (et non 
plus du thread courant, cette fois), sans en modifier la valeur. 

Enfin, on peut rassembler plusieurs threads dans un groupe, c'est-a-dire un objet de 
type ThreadGroup qu'on fournit en argument du constructeur des threads. II est alors 
possible d'envoyer une demande d' interruption par interrupt au groupe, ce qui equivaut 
a l'envoyer a chacun des threads du groupe. 

3.2 Threads demons et arret brutal 

Un programme est done amene a lancer un ou plusieurs threads. Jusqu'ici, nous avons consi- 
dere qu'un programme se terminait lorsque le dernier thread le constituant etait arrete. En 
realite, il existe deux categories de threads : 

• les threads dits utilisateur, 

• les threads dits demons. 

La particularite d'un thread demon est la suivante : si a un moment donne, les seuls threads 
en cours d' execution d'un meme programme sont des demons, ces derniers sont arretes bru- 
talement et le programme se termine. 

Par defaut, un thread est cree dans la categorie du thread qui Pa cree (utilisateur pour main, 
done pour tous les threads, tant qu'on n'a rien demande d'autre). Pour faire d'un thread un 
demon, on effectue l'appel setDaemon (true) avant d'appeler la methode start (si on le fait 
apres ou si Ton appelle plusieurs fois setDaemon, on obtient une exception InvalidThread- 
StateException). 
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Voici une adaptation de l'exemple precedent dans lequel nous avons fait des trois threads des 
threads demons. Le thread principal (main) s'arrete lorsque l'utilisateur frappe un texte quel- 
conque. On constate qu'alors les trois autres threads sont interrompus. Notez bien que si nous 
n'avions pas prevu d' instruction de lecture a la fin du main, les threads auraient ete interrom- 
pus immediatement apres leur lancement. 

public class Demons 

{ public static void main (String args[ ] ) 
{ Ecrit el = new Ecrit ("bonjour ", 5) ; 
Ecrit e2 = new Ecrit ("bonsoir ", 10) ; 
Ecrit e3 = new Ecrit ("\n", 35) ; 
el.setDaemon (true) ; el. start () ; 
e2.setDaemon (true) ; e2. start () ; 
e3.setDaemon (true) ; e3. start () ; 

Clavier . lireString ( ) ; // met fin au main, done ici 

// aux trois autres threads demons 

} 

} 

class Ecrit extends Thread 
{ public Ecrit (String texte, long attente) 
{ this. texte = texte ; 
this. attente = attente ; 

} 

public void run () 
{ try 

{ while (true) // boucle infinie 

{ if (interrupted () ) return ; 
System. out. print (texte) ; 
sleep (attente) ; 

} 

} 

catch ( InterruptedException e) 

{ return ; //on peut omettre return ici 

1 

} 

private String texte ; 
private long attente ; 

} 



Exemple de threads demons 

On notera bien qu'un thread demon est arrete brutalement e'est-a-dire a n'importe quel 
moment de sa methode run. II faut done eviter de rendre demon des threads s'allouant par 
exemple des ressources qu'ils risqueraient de ne jamais liberer en cas d'arret. 
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Informations complementaires 

La methode System.exit met fin a un programme et provoque, elle-aussi, F arret brutal de 
tous les threads en cours (qu'il s'agisse de threads utilisateurs ou de threads demons). 

Par ailleurs, la methode destroy, appliquee a un thread, en provoque egalement 1' arret 
brutal. Son emploi est deconseille depuis la version 2 de Java. 

4 Coordination de threads 

L'avantage des threads sur les processus est qu'ils appartiennent a un meme programme. lis 
peuvent done eventuellement partager les memes objets. Cet avantage s'accompagne parfois 
de contraintes. En effet, dans certains cas, il faudra eviter que deux threads puissent acceder 
(presque) en meme temps au meme objet. Ou encore, un thread devra attendre qu'un autre ait 
acheve un certain travail sur un objet avant de pouvoir lui-meme poursuivre son execution. 

Le premier probleme est regie par l'emploi de methodes mutuellement exclusives qu'on 
appelle souvent, un peu abusivement, "methodes synchronisees", en faisant reference a la 
facon de les declarer avec le mot-cle synchronized. Nous verrons que, dans certains cas, on 
pourra se contenter de "blocs synchronises". 

Le second probleme sera regie par des mecanismes d'attente et de notification mis en ceuvre 
a l'aide des methodes wait et notify. 

4.1 Methodes synchronisees 

Bien que nous n'ayons pas encore passe en revue les differents etats d'un thread, on peut deja 
dire que Fenvironnement peut interrompre un thread (pour donner la main a un autre) a 
n'importe laquelle de ses instructions. 

Prenons un exemple simple de deux threads repetant indefiniment les actions suivantes : 

• incrementation d'un nombre et calcul de son carre (premier thread), 

• affichage du nombre et de son carre (second thread). 

On voit que si le premier thread se trouve interrompu entre F incrementation et le calcul de 
carre, le second risque d'afficher le nouveau nombre et l'ancien carre. 

Pour pallier cette difficulte, Java permet de declarer des methodes avec le mot-cle synchroni- 
zed. A un instant donne, une seule methode ainsi declaree peut etre appelee pour un objet 
donne. 

Remarque 

Ici, nous avons raisonne sur des instructions du langage Java. En toute rigueur, un thread 
peut etre interrompu au niveau de n'importe quelle instruction machine, ce qui ne fait 
qu'accentuer le probleme evoque. 
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4.2 Exemple 

Voyons comment mettre en ceuvre ces methodes synchronisers sur l'exemple simple evoque 
precedemment (un nombre et son carre). Nous allons done partager deux informations (n et 
son carre carre) entre deux threads. Le premier incremente n et calcule son carre dans carre ; 
le second thread se contente d'afficher le contenu de carre. 

Ici, les informations sont regroupees dans un objet nomb de type Nombres. Cette classe dis- 
pose de deux methodes mutuellement exclusives {synchronized) : 

• calcul qui incremente n et calcule la valeur de carre, 

• affiche qui affiche les valeurs de n et de carre. 
Nous creons deux threads de deux classes differentes : 

• calc de classe ThrCalc qui appelle, a son rythme (defini par appel de sleep), la methode cal- 
cul de nomb, 

• qffde classe ThrAff qui appelle, a son rythme (choisi volontairement different de celui de 
calc), la methode affiche de nomb. 

Les deux threads sont lances par main et interrompus lorsque l'utilisateur le souhaite (en 
frappant un texte quelconque). 

public class Synchrl 

{ public static void main (String args[ ] ) 
{ Nombres nomb = new Nombres ( ) ; 
Thread calc = new ThrCalc (nomb) ; 
Thread aff = new ThrAff (nomb) ; 

System. out. println ("Suite de carres - tapez retour pour arreter") ; 

calc. start () ; aff. start () ; 

Clavier . lireString ( ) ; 

calc. interrupt () ; aff. interrupt () ; 

} 

} 

class Nombres 

{ public synchronized void calcul () 
{ n++ ; 

carre = n*n ; 

} 

public synchronized void affiche () 

{ System. out .println (n + " a pour carre " + carre) ; 
} 

private int n=0, carre ; 

} 

class ThrCalc extends Thread 
{ public ThrCalc (Nombres nomb) 

{ this. nomb = nomb ; 

} 
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public void run () 
( try 

{ while (! interrupted () ) 
{ nomb . calcul () ; 
sleep (50) ; 

} 

} 

catch ( InterruptedException e) {} 

} 

private Nombres nomb ; 

} 

class ThrAff extends Thread 
{ public ThrAff (Nombres nomb) 

{ this. nomb = nomb ; 

} 

public void run () 
( try 

{ while (! interrupted () ) 
{ nomb . af f iche ( ) ; 
sleep (75) ; 

} 

} 

catch (InterruptedException e) {} 

} 

private Nombres nomb ; 

} 

1 a pour carre 1 

2 a pour carre 4 

4 a pour carre 16 

5 a pour carre 25 

7 a pour carre 49 

8 a pour carre 64 

10 a pour carre 100 

11 a pour carre 121 

13 a pour carre 169 

14 a pour carre 196 

16 a pour carre 256 

17 a pour carre 289 

Utilisation de methodes synchronisees 

Remarques 

1 Nous ne nous preoccupons pas ici de synchroniser 1 les activites des deux threads ; plus 
precisement, nous ne cherchons pas a attendre qu'une nouvelle incrementation ait lieu 
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avant d'afficher les valeurs, ou qu'un affichage ait eu lieu avant une nouvelle incrementa- 
tion. 

2 Une methode synchronisee appartient a un objet quelconque, pas necessairement a un 
thread. 

3 On peut se demander ce qui se produirait dans l'exemple precedent si les methodes cal- 
cul et affiche n'avait pas ete declarees synchronized. En fait, ici, les methodes ont une 
duree d'execution tres breve, de sorte que la probabilite qu'un thread soit interrompu a 
l'interieur de l'une d'elles est tres faible. Mais nous pouvons accroitre artificiellement 
cette probabilite en ajoutant une attente entre 1' incrementation et le calcul de carre dans 
calcul : 

n++ ; 

try 

{ Thread. sleep (100) ; 
} 

catch ( Inter ruptedException e) {} 
carre = n*n ; 

L' ensemble du programme ainsi modifie figure parmi les fichiers source disponibles en 
telechargement sur www.editions-eyrolles.com sous le nom Synchrla.java. 

4.3 Notion de verrou 

A un instant donne, une seule methode synchronisee peut done acceder a un objet donne. 
Pour mettre en place une telle contrainte, on peut considerer que, pour chaque objet dote d'au 
moins une methode synchronisee, Fenvironnement gere un "verrou" (ou une cle) unique per- 
mettant Faeces a F objet. Le verrou est attribue a la methode synchronisee appelee pour 
Fobjet et il est restitue a la sortie de la methode. Tant que le verrou n'est pas restitue, aucune 
autre methode synchronisee ne peut le recevoir (bien stir, les methodes non synchronisers 
peuvent, quant a elles, acceder a tout moment a Fobjet). 

Rappelons que ce mecanisme d' exclusion mutuelle est base sur Fobjet lui-meme et non sur le 
thread. Cette distinction pourra s'averer importante dans une situation telle que la suivante : 

void synchronized f (...) //on suppose f appelee sur un objet o 
{ // partie I 

g () ; // appel de g sur le meme objet o 

// partie II 

} 

void g(...) // g n'est pas synchronisee 

{ 

} 



1. Comme nous l'avons deja evoque, le mot synchronized est quelque peu trompeur. 
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La methode/ (synchronisee), appelee sur un objet o, appelle la methode g (non synchronisee) 
sur le meme objet. Le verrou de Fobjet o, attribue initialement a/, est rendu lors de l'appel de 
g. La methode g peut alors se trouver interrompue par un autre thread qui peut modifier 
l'objet o. Ainsi, rien ne garantit que o ne sera pas modifie entre l'execution de partie I et celle 
de partie II. En revanche, cette garantie existerait si g etait elle aussi synchronisee. 

Remarque 

Ne confondez pas l'execution de deux methodes differentes dans un meme thread et 
l'execution de deux threads differents (qui peuvent eventuellement appeler une meme 
methode !). 

4.4 L'instruction synchronized 

Une methode synchronisee acquiert done le verrou sur l'objet qui l'a appelee (implicitement) 
pour toute la duree de son execution. L'utilisation d'une methode synchronisee comporte 
deux contraintes : 

• l'objet concerne (celui sur lequel elle acquiert le verrou) est necessairement celui qui Fa ap- 
pelee, 

• l'objet est verrouille pour toute la duree de l'execution de la methode. 

L'instruction synchronized permet d'acquerir un verrou sur un objet quelconque (qu'on cite 
dans l'instruction) pour une duree limitee a l'execution d'un simple bloc : 



synchronized (objet) 

{ instructions 

} 



L'instruction synchronized 

En theorie, on peut faire d'une instruction synchronized une methode (breve) de l'objet con- 
cerne. Par exemple, l'instruction precedente pourrait etre remplacee par l'appel 
ob j ect . f ( . . . ) ; 

dans lequel/serait une methode de l'objet, reduite au seul bloc instructions. 

II y a cependant une exception, a savoir le cas ou l'objet concerne est un tableau car on ne 
peut pas definir de methodes pour un tableau. 

4.5 Interblocage 

L'utilisation des verrous sur des objets peut conduire a une situation de blocage connue sou- 
vent sous le nom d' "etreinte mortelle" qui peut se definir ainsi : 

• le thread tl possede le verrou de l'objet ol et il attend le verrou de l'objet o2, 

• le thread t2 possede le verrou de l'objet o2 et il attend le verrou de l'objet ol. 



Les threads 

Chapitre 1 1 



Comme on peut s'y attendre, Java n'est pas en mesure de detecter ce genre de situation et 
c'est au programmeur qu'il incombe de gerer cette tache. A simple titre indicatif, il existe une 
technique dite d'ordonnancement des ressources qui consiste a numeroter les verrous dans un 
certain ordre et a imposer aux threads de demander les verrous suivant cet ordre. On evite 
alors a coup sur les situations d'interblocage. 

4.6 Attente et notification 

Comme nous Favons dit en introduction de ce paragraphe 4, il arrive que Ton ait besoin de 
coordonner l'execution de threads, un thread devant attendre qu'un autre ait effectue une cer- 
taine tache pour continuer son execution. 

La encore, Java offre un mecanisme base sur l'objet et sur les methodes synchronisees que 
nous venons d'etudier : 

• une methode synchronisee peut appeler la methode wait de l'objet dont elle possede le ver- 
rou, ce qui a pour effet : 

- de rendre le verrou a l'environnement qui pourra, le cas echeant, l'attribuer a une autre 
methode synchronisee, 

- de mettre "en attente" le thread correspondant ; plusieurs threads peuvent etre en atten- 
te sur un meme objet ; tant qu'un thread est en attente, l'environnement ne lui donne 
pas la main ; 

• une methode synchronisee peut appeler la methode notifyAll d'un objet pour prevenir tous 
les threads en attente sur cet objet et leur donner la possibilite de s'executer (le mecanisme 
utilise et le thread effectivement selectionne pourront dependre de l'environnement). 

\^^~ Remarque 

II existe egalement une methode notify qui se contente de prevenir un seul des threads en 
attente. Son utilisation est fortement deconseillee (le thread choisi dependant de l'envi- 
ronnement). 

Exemple 1 

Voici un programme qui gere une "reserve" (de tout ce qui se denombre). II comporte : 

• un thread qui ajoute une quantite donnee, 

• deux threads qui puisent chacun une quantite donnee. 

Manifestement, un thread ne peut puiser dans la reserve que si elle contient une quantite suf- 
fisante. 

La reserve est representee par un objet r, de type Reserve. Cette classe dispose de deux 
methodes synchronisees puise et ajoute. Lorsque la methode puise s'apercoit que la reserve 
est insuffisante, il appelle wait pour mettre le thread correspondant en attente. Parallelement, 
la methode ajoute appelle notifyAll apres chaque ajout. 
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Les trois threads sont lances par main et interrompus lorsque l'utilisateur le souhaite (en frap- 
pant un texte quelconque). 

public class Synchro3 

{ public static void main (String args[ ] ) 
{ Reserve r = new Reserve () ; 

ThrAjout tal = new ThrAjout (r, 100, 15) ; 
ThrAjout ta2 = new ThrAjout (r, 50, 20) ; 
ThrPuise tp = new ThrPuise (r, 300, 10) ; 

System. out. println ("Suivi de stock faire entree pour arreter ") ; 

tal. start () ; ta2. start () ; tp. start () ; 
Clavier . lireString () ; 

tal . interrupt () ; ta2 . interrupt () ; tp. interrupt () ; 

} 

} 

class Reserve extends Thread 

{ public synchronized void puise (int v) throws InterruptedException 
{ if (v <= stock) { System. out. print (" — on puise " + v) ; 
stock -= v ; 

System. out. println (" et il reste " + stock ) ; 

} 

else { System. out. println ("** stock de " + stock 
+ " insuffisant pour puiser " + v ) ; 
wait ( ) ; 

} 

} 

public synchronized void ajoute (int v) 
{ stock += v ; 

System. out. println ("++ on ajoute " + v 

+ " et il y a maintenant " + stock) ; 

notifyAHO ; 

} 

private int stock = 500 ; // stock initial = 500 

} 

class ThrAjout extends Thread 

{ public ThrAjout (Reserve r, int vol, int delai) 

{ this. vol = vol ; this.r = r ; this. delai = delai ; 
} 

public void run () 
{ try 

{ while (! interrupted () ) 

{ r. ajoute (vol) ; sleep (delai) ; 
} 

} 

catch (InterruptedException e) {} 

} 

private int vol ; 
private Reserve r ; 
private int delai ; 
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class ThrPuise extends Thread 

{ public ThrPuise (Reserve r, int vol, int delai) 

{ this. vol = vol ; this.r = r ; this. delai = delai ; 
} 

public void run () 
{ try 

{ while ( ! interrupted ( ) ) 
{ r.puise (vol) ; 
sleep (delai) ; 

} 

} 

catch (InterruptedException e) {} 

} 

private int vol ; 
private Reserve r ; 
private int delai ; 



— on puise 300 et il reste 0 

** stock de 0 insuffisant pour puiser 300 
++ on ajoute 50 et il y a maintenant 50 
++ on ajoute 100 et il y a maintenant 150 
** stock de 150 insuffisant pour puiser 300 
++ on ajoute 50 et il y a maintenant 200 
** stock de 200 insuffisant pour puiser 300 
++ on ajoute 100 et il y a maintenant 300 

— on puise 300 et il reste 0 

** stock de 0 insuffisant pour puiser 300 
++ on ajoute 50 et il y a maintenant 50 

Utilisation de wait et notify All (1) 



Exemple 2 

Dans l'exemple du paragraphe 4.2, les deux threads calc et off n'etaient pas coordonnes ; on 
pouvait incrementer plusieurs fois le nombre avant qu'il n'y ait affichage ou, encore, afficher 
plusieurs fois les memes informations. Ici, nous allons faire en sorte que, malgre leurs ryth- 
mes differents, les deux threads soient coordonnes, c'est-a-dire qu'on effectue alternative - 
ment une incrementation et un calcul. Pour ce faire, nous utilisons les methodes wait et 
notifyAll, ainsi qu'un indicateur booleen pret permettant aux deux threads de communiquer 
entre eux. 



public class Synchr4 

{ public static void main (String args[ ] ) 
{ Nombres nomb = new Nombres ( ) ; 

Thread calc = new ThrChange (nomb) ; 
Thread aff = new ThrAff (nomb) ; 

System. out. println ("Suite de carres - tapez retour pour arreter") ; 
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calc. start () ; af f. start () ; 

Clavier. lireStringO ; 

calc . interrupt ( ) ; af f . interrupt ( ) ; 

} 

} 

class Nombres 

{ public synchronized void calculi ) throws InterruptedException 
{ if (!pret) 
{ n++ ; 

carre = n*n ; 
pret = true ; 
notifyAlll) ; 

} 

else wait () ; 

} 

public synchronized void affiche () 
{ try 

{ if (pret) 

{ System. out. println (n + " a pour carre " + carre) ; 
notifyAll() ; 
pret = false ; 

} 

else wait () ; 

} 

catch (InterruptedException e) {} 

} 

public boolean pret () 

{ return pret ; 

} 

private int n=l, carre ; 
private boolean pret = false ; 

} 

class ThrChange extends Thread 
{ public ThrChange (Nombres nomb) 

{ this. nomb = nomb ; 

} 

public void run () 
{ try 

{ while (! interrupted () ) 
{ nomb . calcul ( ) ; 
sleep (5) ; 

} 

} 

catch (InterruptedException e) {} 

} 

private Nombres nomb ; 
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class ThrAff extends Thread 
{ public ThrAff (Nombres norrib) 

{ this.nomb = norrib ; 

} 

public void run () 
{ try 

{ while (! interrupted () ) 
{ norrib. af f iche () ; 
sleep (2) ; 

} 

} 

catch (InterruptedException e) {} 

} 

private Nombres norrib ; 



56 a pour 

57 a pour 

58 a pour 

59 a pour 

60 a pour 

61 a pour 

62 a pour 

63 a pour 

64 a pour 



car re 3136 
carre 3249 
carre 3364 
carre 3481 
carre 3600 
carre 3721 
carre 3844 
carre 3969 
carre 4096 



Utilisation de wait et notify All (2) 

5 Etats d'un thread 

Nous avons deja vu comment un thread pouvait etre mis en sommeil ou mis en attente du ver- 
rou d'un objet. Nous allons ici faire le point sur les differents "etats" dans lesquels peut se 
trouver un thread et sur les actions qui le font passer d'un etat a un autre. 

Au depart, on cree un objet thread. Tant que Ton ne fait rien, il n'a aucune chance d'etre exe- 
cute. L'appel de start rend le thread disponible pour F execution. II est alors considere comme 
pret. L'environnement peut faire passer un thread de l'etat pret a l'etat "en cours d'execu- 
tion" . On notera bien que cette transition ne peut pas etre programmee explicitement. C'est le 
systeme qui decide (en utilisant eventuellement des requetes formulees par le programme). 

Un thread en cours d' execution peut subir differentes actions : 

• II peut etre interrompu par l'environnement qui le ramene a l'etat pret ; c'est ce qui se pro- 
duit lorsque Ton doit donner la main a un autre thread (sur le meme processeur). Cette tran- 
sition peut etre "programmee" en appelant la methode yield de la classe Thread ; on notera 
bien qu' alors rien ne dit que ce meme thread ne sera pas a nouveau place en execution (par 
exemple, si aucun autre thread n'est pret). 
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• II peut etre mis "en sommeil" par appel de la methode sleep. Cet etat est different de pret car 
un thread en sommeil ne peut pas etre lance par l'environnement. Lorsque le temps de som- 
meil est ecoule, l'environnement replace le thread dans l'etat pret (il ne sera relance que 
lorsque les circonstances le permettront). 

• II peut etre mis dans une liste d'attente associee a un objet (appel de wait). Dans ce cas, c'est 
F appel de notifyAll qui le ramenera a l'etat pret. 

• II peut lancer une operation d' entree-sortie et il se trouve alors bloque tant que 1' operation 
n'est pas terminee. 

• II peut s'achever. 




Les diffe rents etats d'un thread 



6 Priorites des threads 

Jusqu'ici, nous n'avons pas agi sur la priori te des threads qui possedaient alors tous la meme 
priorite par defaut. En theorie, il est possible de modifier la priorite d'un thread a l'aide de la 
methode setPriority a laquelle on fournit en argument une valeur entiere comprise entre 
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MIN.PRIORITY (en fait 1) et MAX.PRIORITY (en fait 10) ; la priorite par defaut etant repre- 
sentee par NORM. PRIORITY (en fait 5). 

La priorite d'un thread est exploitee par Fenvironnement de la facon suivante : 

• lorsqu'il peut donner la main a un thread, il choisit celui de plus haute priorite parmi ceux 
qui sont dans Fetat pret ; s'il y a plusieurs threads candidats, le thread choisi dependra de 
l'environnement ; 

• si un thread plus priori taire que le thread en cours d' execution devient pret, on lui donne la 
main (F autre thread passant a Fetat pret). 

Aucune garantie n'est fournie quant a la repartition equitable du temps d' execution entre dif- 
ferents threads de meme priorite. Comme nous l'avons deja evoque, suivant les environne- 
ments, on pourra avoir un partage de temps systematique entre ces threads ou, au contraire, 
voir un thread s'executer totalement avant qu'un autre n'obtienne la main. On notera que 
d'eventuels appels de yield ne changent rien a ce probleme. En revanche, comme nous 
l'avons vu, des appels judicieux de sleep peuvent permettre d'aboutir a une relative indepen- 
dance de l'environnement. 

D'une maniere generale, il n'est guere conseille d'agir sur les priorites des threads dans des 
programmes qui se veulent portables. 
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la programmation graphique 



Au chapitre 1, nous avons sommairement indique ce qui distingue un programme a interface 
console d'un programme a interface graphique. Dans le premier cas, c'est le programme qui 
pilote l'utilisateur en le sollicitant au moment voulu pour qu'il foumisse des informations ; le 
dialogue se fait en mode texte et de facon sequentielle, dans une fenetre nommee "console". 
Dans le second cas, au contraire, l'utilisateur a l'impression de piloter le programme qui rea- 
git a des demandes qu'il exprime en selectionnant des articles de menu, en cliquant sur des 
boutons, en remplissant des boites de dialogue... Malgre l'adjectif "graphique" utilise dans 
l'expression "interface graphique", la principale caracteristique de ces programmes reside 
dans la notion de programmation evenementielle. 

Jusqu'ici, pour vous faciliter l'apprentissage des fondements de Java et de la programmation 
orientee objet, nous n' avons realise que des programmes a interface console. Ce chapitre 
aborde les bases de la programmation graphique avec Swing, API graphique la plus utilisee 
en Java 1 . 

Nous commencerons par vous montrer comment creer une fenetre graphique et nous verrons 
comment gerer l'evenement le plus simple, constitute par un clic dans cette fenetre. Cela nous 
amenera a vous presenter la notion fondamentale d'ecouteur d'evenement. Nous apprendrons 
ensuite comment introduire un composant dans une fenetre, en utilisant l'exemple du compo- 



1 . Initialement Java ne disposait que de 1' API AWT qui reposait sur des composants dits "lourds" et dependants 
du systeme d' exploitation. L'API Swing est apparue des Java 2, en proposant des composants dits "legers", 
independants du systeme d' exploitation, et dotes de proprietes plus riches que ceux de AWT. Les deux API 
utilisent des concepts semblables, mais pas totalement identiques. 
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sant le plus naturel qu'est le bouton. Nous decouvrirons alors la souplesse du modele de ges- 
tion des evenements de Java, qui offre differentes possibilites d' associations entre evenement 
et ecouteur. 

Nous aborderons ensuite la notion de dessin sur un composant ou dans une fenetre (par 
1' intermediate d'un panneau) et nous verrons comment en assurer la permanence en redefi- 
nissant la methode paintComponent. Enfin, nous apporterons quelques precisions concernant 
la gestion des dimensions des composants. 



1 Premiere fenetre 

Comme vous avez pu le constater au fil des precedents chapitres, l'execution d'un pro- 
gramme Java entraine automatiquement la creation d'une fenetre console. Mais rien de com- 
parable n'est prevu pour une fenetre graphique destinee a servir de support a la 
programmation evenementielle. Le programme doit done la creer explicitement. Nous allons 
voir ici comment y parvenir. Par souci de simplicite, nous nous limiterons a la seule creation 
de cette fenetre. Par la suite, nous verrons comment en faire le support de l'interface avec 
l'utilisateur en introduisant les composants voulus (menus, boutons, boites de dialogue..) et 
en gerant convenablement les evenements correspondants. 



1.1 La classe J Frame 

Pour creer une fenetre graphique, on dispose, dans le paquetage nomme javax. swing, d'une 
classe standard nommee JFrame, possedant un constructeur sans arguments. Par exemple, 
avec : 

JFrame fen = new JFrame ( ) ; 

On cree un objet de type JFrame et on place sa reference dans fen. 

Mais si on se limite a cela, rien n'apparaitra a l'ecran. II est en effet necessaire de demander 
l'affichage de la fenetre en appelant la methode setVisible 1 : 

fen.setvisible (true) ; // rend visible la fenetre de reference fen 

Comme par defaut, une telle fenetre est creee avec une taille nulle, il est necessaire d'en defi- 
nir les dimensions auparavant ; par exemple : 

fen.setSize (300, 150) ; // donne a la fenetre une hauteur de 150 pixels 

// et une largeur de 300 pixels 

En general, on choisira d'afficher un texte precis dans la barre de titre. Pour ce faire, on utili- 
sera la methode setTitle, par exemple : 

fen.setTitle ("Ma premiere fenetre") ; 

Voici un programme tres simple de creation d'une fenetre graphique : 



1 . Au lieu de setVisible( true), on pourrait utiliser l'appel show( ) (la methode show est heritee de Window). Mais 
la demarche ne serait pas generalisable a tous les composants (boutons, cases...). 
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import javax. swing.* ; 
public class PremfenO 

{ public static void main (String args[ ] ) 
{ JFrame fen = new JFrame ( ) ; 
fen.setSize (300, 150) ; 
fen.setTitle ("Ma premiere fenetre") ; 
fen. setvisible (true) ; 

} 

} 

Creation d' une fenetre graphique simple 

Son execution conduit, en plus de l'affichage de la fenetre console (lorsqu'elle n'existe pas 
deja), a celui de la fenetre graphique suivante : 



^Ma premiere fenetre HFsJd 



| | 

La fenetre graphique creee par le programme precedent 

Bien que vous n'ayez rien prevu de particulier, Futilisateur peut manipuler cette fenetre 
comme n'importe quelle fenetre graphique d'un logiciel du commerce, et en particulier : 

• la retailler, 

• la deplacer (ici, elle s'est affichee dans le coin haut gauche de l'ecran), 

• la reduire a une icone. 

Ces fonctionnalites, communes a toutes les fenetres, sont prises en charge par la classe 
JFrame elle-meme. Vous n'avez done pas a vous soucier de la gestion des evenements corres- 
pondants tels que le clic sur une de ses cases, le glisse {drag) d'une bordure... 

Remarque 

Si vous souhaitez mettre en evidence les differences entre la fenetre console et la fenetre 
graphique que nous venons de creer, vous pouvez ajouter quelques instructions d'affi- 
chage dans votre programme, par exemple : 
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import javax. swing.* ; 
public class PremfenO 

{ public static void main (String args[ ] ) 
{ System. out. println ("debut main") ; 
JFrame fen = new JFrame ( ) ; 
fen.setSize (300, 150) ; 
fen.setTitle ("Ma premiere fenetre") ; 
System. out .println ("avant affichage fenetre") ; 
fen. setvisible (true) ; 
System. out .println ("fin main") ; 

} 

} 



1 .2 Arret du programme 

A priori, vous pouniez penser que 1' execution de la methode main arrivant a son terme, 
l'application s'interrompt. Fort heureusement, la fenetre graphique reste convenablement 
affichee 1 . En fait, un programme Java peut comporter plusieurs processus independants 
qu'on nomme threads. Ici, on trouve un thread principal correspondant a la methode main et 
un thread utilisateur lance par l'affichage de la fenetre graphique. A la fin de la methode 
main, seul le thread principal est interrompu 2 . 

Generalement, dans une application graphique, on est habitue a ce que la fermeture de la 
fenetre de l'application mette fin au programme. Or ici, vous pouvez certes fermer la fenetre 
graphique (par clic sur sa case de fermeture, par Foption Fermeture de son menu systeme, par 
double clic sur sa case systeme). Mais cela ne met pas fin au thread d' interface utilisateur. 
Nous verrons plus tard (paragraphe 3 du chapitre 16) qu'on peut y parvenir en traitant conve- 
nablement l'evenement fermeture de la fenetre. Pour l'instant, vous pouvez vous contenter 
d'utiliser une methode plus rudimentaire, a savoir : 

• sous Unix ou Linux : frapper CTRL/C dans la fenetre console ; 

• sous Windows : fermer la fenetre console. 

Notez que cette action fait disparaitre la fenetre graphique si elle n'a pas deja ete fermee. 

1 .3 Creation d'une classe fenetre personnalisee 

Dans l'exemple precedent, nous avons simplement cree un objet de type JFrame et nous 
avons utilise les fonctionnalites presentes dans cette classe. Mais pour que notre programme 
presente un interet, il va de soi qu'il faut lui associer des fonctionnalites ou des champs 
supplementaires ; de fait, la fenetre devra pouvoir reagir a certains evenements. Pour cela, il 



1. II en va d'ailleurs de meme de la fenetre console. 

2. Attention a ne pas associer le thread principal lance par la methode main avec la fenetre console ; cette der- 
niere continue d'exister apres la fin de la methode main. Vous aurez d'ailleurs souvent l'occasion d'y effectuer 
des affichages par la suite... 
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nous faudra generalement definir notre propre classe derivee de JFrame et creer un objet de 
ce nouveau type. 

Voici comment nous pourrions transformer dans ce sens le precedent programme (pour l'ins- 
tant, cette transformation est artificielle puisque le nouveau programme ne fait rien de plus 
que F ancien) : 

import javax. swing.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () // constructeur 
{ setTitle ("Ma premiere fenetre") ; 
setSize (300, 150) ; 

} 

} 

public class Premfenl 

{ public static void main (String args[ ] ) 
{ JFrame fen = new MaFenetre ( ) ; 
fen. setvisible (true) ; 

} 

} 

Utilisation d'une classe fenetre personnalisee 

\^^~ Remarque 

Ici, nous n'avons cree qu'une seule fenetre pour une application, comme c'est generale- 
ment l'usage. Mais rien ne vous empecherait d'en creer plusieurs. 

1 .4 Action sur les caracteristiques d'une fenetre 

Ici, le titre et les dimensions de la fenetre sont fixes une fois pour toutes avant son affichage 
dans le constructeur de la classe MaFenetre. lis pourraient aussi l'etre depuis la methode 
main, et meme modifies au fil de l'execution du programme. D'une maniere generale, nous 
aurons 1' occasion de voir comment agir sur certains parametres d'une fenetre, comme 
d'ailleurs des autres composants. 

Pour l'instant, sachez que vous pouvez fixer non seulement les dimensions, mais aussi la 
position de la fenetre a l'ecran, en utilisant la methode setBounds : 

f en . setBounds (10, 40, 300, 200) ; // le coin superieur gauche de la fenetre 
// est place au pixel de coordonnees 10, 40 
// et ses dimensions seront de 300 * 200 pixels 

Notez que l'origine des coordonnees coincide avec le coin superieur gauche de l'ecran. L'axe 
des abscisses est oriente vers la droite, celui des ordonnees vers le bas (on n'a pas affaire a un 
systeme orthonorme usuel). 

Par la suite, nous aurons l'occasion d'utiliser des methodes comme setBackground (modifica- 
tion de la couleur de fond ou encore getSize (obtention de la taille courante). 
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Pour l'heure, voici un petit programme d'ecole qui vous permet de modifier quelques carac- 
teristiques de la fenetre graphique a partir d' informations entrees dans la fenetre console. Son 
experimentation (voire quelques tentatives de modifications) pourra constituer un bon pre- 
texte pour vous familiariser avec ces nouvelles techniques de programmation graphique. 



import javax. swing.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () // constructeur 
{ setTitle ("Ma premiere fenetre") ; 
setBounds (50, 100, 300, 150) ; 

} 

} 

public class Premfen2 

( public static void main (String args[ ] ) 
{ JFrame fen = new MaFenetre ( ) ; 
fen. setvisible (true) ; 

while (true) // fin sur longueur titre nulle 
{ System. out. print ("nouvelle largeur : ") ; 

int larg = Clavier. lirelnt () ; 

System. out. print ("nouvelle hauteur : ") ; 

int haut = Clavier. lirelnt () ; 

System. out. print ("nouveau titre : (vide pour finir) ") ; 
String tit = Clavier . lireString () ; 
if (tit. length () == 0) break ; 
fen.setSize (larg, haut) ; 
fen. setTitle (tit) ; 

} 

} 

} 



Modification des caracteristiques d 'une fenetre 



Informations complementaires 

Nous avons vu que la fermeture de la fenetre graphique la faisait disparaitre. Pour etre 
precis, il faudrait dire que cela la rend simplement invisible (comme si Ton appelait setVi- 
sible(falsef). A la rigueur, il serait possible de la faire reapparaitre. On peut imposer un 
autre comportement lors de la fermeture de la fenetre, en appelant la methode setDefault- 
CloseOperation de JFrame avec l'un des arguments suivants : 

- DO_NOTHING_ON_CLOSE : ne rien faire, 

- HIDE_ON_CLOSE : cacher la fenetre (comportement par defaut), 

- DISPOSE_ON_CLOSE : detruire 1 ' obj et fenetre . 

Mais, en aucun cas, la fermeture de la fenetre ne mettrait fin a 1' application. 
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2 Gestion d'un die dans la fenetre 

Comme nous Favons deja dit, la programmation evenementielle constitue la caracteristique 
essentielle d'une interface graphique. La plupart des evenements sont crees par des compo- 
sants qu'on aura introduits dans la fenetre (menus, boutons, boites de dialogue...)- Mais avant 
d'apprendre a creer ces composants, nous allons voir comment traiter les evenements qu'ils 
generent. Nous nous fonderons pour cela sur un evenement qui a le merite de ne pas 
necessiter la creation d'un nouvel objet : un clic dans la fenetre principale. Les differentes 
demarches a suivre pour gerer cet evenement seront tres facilement generalisables aux autres 
evenements. 

2.1 Implementation de I'interface MouseListener 

Voyons done comment traiter l'evenement que constitue un clic dans la fenetre principale. 
Par souci de simplicite, nous nous contenterons pour l'instant de signaler l'evenement en affi- 
chant un message dans la fenetre console. 

En Java, tout evenement possede ce que Ton nomme une source. II s'agit de l'objet lui ayant 
donne naissance : bouton, article de menu, fenetre... Dans notre exemple, cette source sera la 
fenetre principale. 

Pour traiter un evenement, on associe a la source un objet de son choix dont la classe imple- 
mente une interface particuliere correspondant a une categorie d' evenements. On dit que cet 
objet est un ecouteur de cette categorie d'evenements. Chaque methode proposee par I'inter- 
face correspond a un evenement de la categorie. Ainsi, il existe une categorie d' evenements 
souris qu'on peut traiter avec un ecouteur de souris, e'est-a-dire un objet d'une classe imple- 
mentant I'interface MouseListener. Cette derniere comporte cinq methodes correspondant 
chacune a un evenement particulier : mousePressed, mouseReleased, mouseEntered, 
mouseExited et mouseClicked. 

Une classe susceptible d'instancier un objet ecouteur de ces differents evenements devra 
done correspondre a ce schema (nous parlerons un peu plus tard du type MouseEvent de 
1' unique argument de ces differentes methodes) : 

class EcouteurSouris implements MouseListener 

{ public void mouseClicked (MouseEvent ev) { } 

public void mousePressed (MouseEvent ev) { } 

public void mouseReleased (MouseEvent ev) { } 

public void mouseEntered (MouseEvent ev) { } 

public void mouseExited (MouseEvent ev) { } 

// autres methodes et champs de la classe 

} 

Pour l'instant, nous n'entrerons pas trop dans les details et nous nous contenterons de savoir 
que l'evenement mouseClicked correspond a un clic usuel (appui suivi de relachement, sans 
deplacement). C'est done celui qui nous interesse ici, et que nous traiterons done en redefi- 
nissant ainsi la methode mouseClicked : 
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public void mouse-Clicked (Mouse-Event ev) 
{ System. out .println ("die dans fenetre") ; 
} 

Mais comme notre classe doit implementer F interface MouseListener, elle doit en redefinir 
toutes les methodes. Nous pouvons toutefois nous permettre de ne rien faire de particulier 
pour les autres evenements, et done de fournir des methodes "vides". 

Pour traiter un clic souris dans notre fenetre, il suffit done d'associer a notre fenetre un objet 
d'un type tel que EcouteurSouris. Pour ce faire, nous utilisons la methode addMouseListener. 
Cette derniere figure dans toutes les classes susceptibles de generer des evenements souris, 
en particulier dans JFrame. Nous pouvons done introduire dans le constructeur de notre fene- 
tre une instruction de la forme : 

addMouseListener (objetEcouteur) ; 

dans laquelle objetEcouteur est un objet d'une classe du type EcouteurSouris dont nous 
venons de fournir le schema. 

Java se montre ici tres souple puisque F objet ecouteur peut etre n'importe quel objet dont la 
classe implemente Finterface voulue. Dans une situation aussi simple qu'ici, nous pouvons 
meme ne pas creer de classe separee telle que EcouteurSouris en faisant de la fenetre elle- 
meme son propre ecouteur d'evenements souris. Notez que cela est possible car la seule 
chose qu'on demande a un objet ecouteur est que sa classe implemente Finterface voulue (ici 
MouseListener). Nous pouvons done adopter ce schema : 

class MaFenetre extends JFrame implements MouseListener 
{ public MaFenetre () // constructeur 
{ 

addMouseListener (this) ; // la fenetre sera son propre ecouteur 

// d' evenements souris 

} 

public void mouseClicked (MouseEvent ev) // methode gerant un clic souris 

{ System. out .println ("clic dans fenetre") ; 

} 

public void mousePressed (MouseEvent ev) { } 
public void mouseReleased (MouseEvent ev) {} 
public void mouseEntered (MouseEvent ev) { } 
public void mouseExited (MouseEvent ev) { } 

} 

// autres methodes de la classe MaFenetre 

} 

Voici un programme complet qui se contente d'afficher en fenetre console un message a cha- 
que clic dans la fenetre graphique : 

import javax. swing.* ; // pour JFrame 

import java.awt. event.* ; // pour MouseEvent et MouseListener 
class MaFenetre extends JFrame implements MouseListener 
{ public MaFenetre () // constructeur 
{ setTitle ("Gestion de dies") ; 
setBounds (10, 20, 300, 200) ; 
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addMouseListener (this) ; // la fenetre sera son propre ecouteur 

/ / d evenements souris 

} 

public void mouseClicked (MouseEvent ev) // methode gerant un clic souris 

{ System. out. println ("clic dans fenetre") ; 

} 

public void mousePressed (MouseEvent ev) { ) 
public void mouseReleased (MouseEvent ev) { ) 
public void mouseEntered (MouseEvent ev) { ) 
public void mouseExited (MouseEvent ev) { } 

} 

public class Clicl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Main [Application Java] C:\Program Files\]ava\j dkl. 5.0\bin\javaw.exe (13 nov. 2005 17:01:58) 
clic dans fenetre 
clic dans fenetre 
clic dans fenetre 
clic dans fenetre 
clic dans fenetre 
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Inscriptive Inser...ancee 14 : 1 



Gestion de I 'evenement "clic dans la fenetre " 



Remarques 

1 Notez la presence, en plus de import javax.swing.*, d'une nouvelle instruction import 
java.awt. event.*. En effet, la gestion des evenements fait appel au paquetage 
java.awt. event. 

2 Les methodes telles que mouseClicked doivent obligatoirement etre declarees publiques 
car une classe ne peut pas restreindre les droits d'acces d'une methode qu'elle imple- 
mente. 

3 Si dans le constructeur de MaFenetre, vous omettez 1' instruction addMouseListener 
(this), vous n'obtiendrez pas d'erreur de compilation. Cependant, aucune reponse ne 
sera apportee aux clics. 
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4 Vous pouvez verifier que les seuls clics pris en compte sont ceux qui se produisent dans 
la partie utile de la fenetre de 1' application. Par exemple, les clics dans la barre de titre 
ne fournissent aucun message, pas plus que les clics dans une autre fenetre. De meme, 
si vous effectuez un "glisser" (drag) de la souris, c'est-a-dire si, apres avoir enfonce le 
bouton de gauche, vous deplacez la souris, avant de relacher le bouton, vous n'obtien- 
drez la non plus aucun message ; ceci provient de ce que l'evenement correspondant est 
different (en fait, comme nous le verrons plus tard, il appartient meme a une autre cate- 
gorie nommee MouseMotionEvent) . 

2.2 Utilisation de I'information associee a un evenement 

Jusqu'ici, nous ne nous sommes pas preoccupes de F argument transmis a la methode mouse- 
Clicked. Ici, il s'agit d'un objet de type MouseEvent. Cette classe correspond en fait a la cate- 
gorie d'evenements geres par l'interface MouseListener. Un objet de cette classe est 
automatiquement cree par Java lors du clic, et transmis a l'ecouteur voulu. II contient un cer- 
tain nombre d' informations 1 , en particulier les coordonnees du curseur de souris au moment 
du clic, lesquelles sont accessibles par des methodes getX et getY. 

Voici une adaptation du programme precedent qui utilise ces methodes getX et getY pour 
ajouter les coordonnees du clic au message affiche en fenetre console : 

import javax. swing.* ; 
import java.awt. event.* ; 

class MaFenetre extends JFrame implements MouseListener 
{ MaFenetre () // constructeur 
{ setTitle ("Gestion de clics") ; 
setBounds (10, 20, 300, 200) ; 

addMouseListener (this) ; //la fenetre sera son propre ecouteur 

// d' evenements souris 

} 

public void mouseClicked (MouseEvent ev) // methode gerant un clic souris 
{ int x = ev . getX ( ) ; 
int y = ev . getY ( ) ; 

System. out .println ("clic au point de coordonnees " + x + ", " + y ) ; 

} 

public void mousePressed (MouseEvent ev) { } 
public void mouseReleased (MouseEvent ev) {} 
public void mouseEntered (MouseEvent ev) { } 
public void mouseExited (MouseEvent ev) { } 

) 



1. Comme on peut s'y attendre, ces methodes d'obtention des coordonnees sont specifiques a MouseEvent. 
D'autres, en revanche, seront communes a tous les evenements ; ce sera notamment le cas de la methode get- 
Source dont nous parlerons bientot. 
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public class Clic2 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Gestion de V evenement "clic dans la fenetre" avec affichage des coordonnees du clic 

\^^~ Remarque 

Les coordonnees du clic sont relatives au composant concerne (ici la fenetre) et non a 
Fecran. Leur origine correspond au coin superieur gauche du composant. 

2.3 La notion d'adaptateur 

Dans les exemples precedents, nous n'avions besoin que de la methode mouseClicked. Mais 
nous avons du fournir des definitions vides pour les autres afin d'implementer correctement 
toutes les methodes requises par F interface MouseListener. 

Pour vous faciliter les choses, Java dispose d'une classe particuliere MouseAdapter qui 
implemente toutes les methodes de F interface MouseListener avec un corps vide. Autrement 
dit, tout se passe comme si MouseAdapter etait definie ainsi : 

class MouseAdapter implements MouseListener 

{ public void mouseClicked (MouseEvent ev) { } 

public void mousePressed (MouseEvent ev) { } 

public void mouseReleased (MouseEvent ev) { } 

public void mouseEntered (MouseEvent ev) { } 

public void mouseExited (MouseEvent ev) { } 

} 
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Dans ces conditions, vous pouvez facilement definir une classe ecouteur des evenements sou- 
ris ne comportant qu'une methode (par exemple mouseClicked), en procedant ainsi : 

class EcouteurSouris extends MouseAdapter 

{ public void mouseClicked (MouseEvent e) // ici, on ne redefinit 

{ // que la (ou les) methode (s) qui 

} // nous interesse (nt) 

} 

Voici un schema recapitulatif montrant comment utiliser cette technique pour n'ecouter, a 
l'aide d'un objet d'une classe EcouteurSouris, que les clics complets generes par une 
fenetre : 

class MaFenetre extends JFrame 
1 

addMouseListener (new EcouteurSouris () ) ; 

} 

class EcouteurSouris extends MouseAdapter 

{ public void mouseClicked (MouseEvent ev) // seule la methode mouseClicked 
{ } // nous interesse ici 

} 

Cependant, si Ton precede ainsi, les deux classes MaFenetre et EcouteurSouris sont indepen- 
dantes. Dans certains programmes, on preferera que la fenetre concernee soit son propre 
ecouteur (comme nous l'avons fait dans les exemples precedents n'utilisant pas d'adapta- 
teur). Dans ce cas, un petit probleme se pose : la classe fenetre correspondante ne peut pas 
deriver a la fois de JFrame et de MouseAdapter 1 . C'est la que la notion de classe anonyme 
(presentee au paragraphe 15 du chapitre 8) prend tout son interet. II suffit en effet de rempla- 
cer le canevas precedent par le suivant : 
class MaFenetre extends JFrame 



addMouseListener (new MouseAdapter 

{ public void mouseClicked (MouseEvent ev) 



} ) 



Ici, on a cree un objet d'un type classe anonyme derivee de MouseAdapter et dans laquelle on 
a redefini de facon appropriee la methode mouseClicked. 

Voici comment nous pouvons transformer dans ce sens le programme du paragraphe 2.2 : 



import javax.swinq.* ; 
import j ava . awt . event . 



1. Ce probleme ne se posait pas quand on utilisait une interface au lieu d'une classe adaptateur, car une meme 
classe peut a la fois deriver d'une autre et implementer une interface. 
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class MaFenetre extends JFrame 
{ public MaFenetre () // constructeur 
{ setTitle ("Gestion de dies") ; 
setBounds (10, 20, 300, 200) ; 
addMouseListener ( new MouseAdapter ( ) 
{ public void mouseClicked (MouseEvent ev) 
{ int x = ev . getX ( ) ; 
int y = ev . getY ( ) ; 

System. out. println ("clic au point de coordonnees " + x + ", " + y ) ; 

} 

} ) ; 

} 

} 

public class Clic3 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 

Exemple d' utilisation de V adaptateur Mouse Adapter 

2.4 La gestion des evenements en general 

Nous venons de vous montrer comment un evenement, declenche par un objet nomme 
source, pouvait etre traite par un autre objet nomme ecouteur prealablement associe a la 
source. Tout ce qui a ete expose ici sur un exemple simple se generalisera aux autres evene- 
ments, quels qu'ils soient et quelle que soit leur source. 

En particulier, a une categorie donnee Xxx, on associera toujours un objet ecouteur des eve- 
nements (de type XxxEvent), par une methode nommee addXxxListener. Chaque fois qu'une 
categorie donnee disposera de plusieurs methodes, on pourra : 

• soit redefinir toutes les methodes de l'interface correspondante XxxListener (la clause im- 
plements XxxListener devant figurer dans l'en-tete de classe de 1' ecouteur), certaines me- 
thodes pouvant avoir un corps vide ; 

• soit faire appel a une classe derivee d'une classe adaptateur XxxAdapter et ne fournir que les 
methodes qui nous interessent (lorsque la categorie ne dispose que d'une seule methode, 
Java n'a pas prevu de classe adaptateur car elle n'aurait aucune utilite). 

L' objet ecouteur pourra etre n'importe quel objet de votre choix ; en particulier, il pourra 
s'agir de l'objet source lui-meme. Un programme peut se permettre de ne considerer que les 
evenements qui l'interessent ; les autres sont pris automatiquement en compte par Java et ils 
subissent un traitement par defaut. Par exemple, dans les exemples precedents, nous ne nous 
sommes pas interesses aux clics dans la fenetre (dans ce cas, le traitement par defaut consis- 
tait a ne rien faire). Enfin, bien que nous n'ayons pas rencontre ce cas jusqu'ici, sachez qu'un 
meme evenement peut tout a fait disposer de plusieurs ecouteurs. 
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3 Premier composant : un bouton 

Jusqu'ici, nous n'avons pas introduit de composant particulier dans la fenetre graphique. 
Nous allons maintenant voir comment y placer un bouton et intercepter les actions correspon- 
dantes. Notez qu'il s'agit la du composant le plus simple qui soit, et dont Fusage est certaine- 
ment le plus intuitif. 

3.1 Creation d'un bouton et ajout dans la fenetre 

On cree un objet bouton en utilisant le constructeur de la classe JButton, auquel on communi- 
que le texte qu'on souhaite voir figurer a l'interieur : 

JButton monBouton ; 

monBouton = new JButtton ("ESSAI") ; // creation cf un bouton portant 

// 1' etiquette "ESSAI" 

II faut ensuite introduire ce composant dans la fenetre. Ici, les choses sont un peu moins natu- 
relles, car un objet de type JFrame possede une structure a priori quelque peu complexe. En 
effet, il est theoriquement forme d'une superposition de plusieurs elements, en particulier une 
racine, un contenu et une vitre. En general, il vous suffit de savoir que c'est sa partie contenu 
qui nous interesse puisque c'est a elle que nous incorporerons les differents composants. La 
methode getContentPane de la classe JFrame fournit la reference a ce contenu, de type Con- 
tainer 1 . Ainsi, depuis une methode quelconque d'une fenetre, nous obtiendrons une reference 
a son contenu par : 

Container c = getContentPane ( ) ; 

D' autre part, la methode add de la classe Container 2 permet d'ajouter un composant quelcon- 
que a un objet de ce type. Pour ajouter le bouton precedent (de reference monBouton) au con- 
tenu de reference c, il suffit de proceder ainsi : 

c . add (monBouton ) ; 

Bien entendu, si Ton n'a pas besoin de c par ailleurs, on pourra condenser ces deux instruc- 
tions en : 

getContentPane ( ) . add (monBouton) ; 

3.2 Affichage du bouton : la notion de gestionnaire 
de mise en forme 

Nous venons de voir comment creer un nouveau bouton et nous pouvons introduire les ins- 
tructions evoquees dans le constructeur de notre fenetre : 



1 . Nous verrons plus tard que cette classe est une classe abstraite, ascendante de toutes les classes utilisees dans 
une interface graphique. A titre indicatif, sachez que l'annexe E fournit la liste hierarchique des differentes clas- 
ses utilisees dans cet ouvrage. 

2. Elle se trouve dans le paquetage java.awt. 
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class FenlBouton extends JFrame 
{ public FenlBouton () 

{ setTitle ("Premier bouton") ; 

setSize (300, 200) ; 

monBouton = new JButton ("ESSAI") ; 

getContentPane ( ) .add (monBouton) ; 

} 

JButton monBouton ; 

} 

Notez que, contrairement a une fenetre, un bouton est visible par defaut ; il est done inutile de 
lui appliquer la methode setVisible(true) (mais cela reste possible). Si nous affichons notre 
fenetre, nous constatons toutefois que le bouton est bien present, mais qu'il occupe tout 
l'espace disponible 1 . 

En fait, la disposition des composants dans une fenetre est geree par ce qu'on nomme un 
gestionnaire de raise en forme ou encore de disposition (en anglais Layout Manager). II 
existe plusieurs gestionnaires (foumis, naturellement, sous forme de classes) utilisant des 
regies specifiques pour disposer les composants. Nous les etudierons en detail par la suite. 
Pour l'instant, sachez que, par defaut, Java utilise un gestionnaire de classe BorderLayout 
avec lequel, en l'absence d'informations specifiques, un composant occupe toute la fenetre 2 . 

Mais il existe un gestionnaire plus interessant, de la classe FlowLayout, qui dispose les diffe- 
rents composants "en flot", e'est-a-dire qu'il les affiche un peu comme du texte, les uns a la 
suite des autres, d'abord sur une meme "ligne", puis ligne apres ligne... Nous verrons plus 
tard que ce gestionnaire permet egalement d'agir sur la taille des composants. 

Pour choisir un gestionnaire, il suffit d' appliquer la methode setLayout a l'objet contenu de la 
fenetre (n'oubliez pas que e'est deja a l'objet contenu qu'on ajoute les composants). Ainsi, 
pour obtenir un gestionnaire du type FlowLayout souhaite, nous procederons comme ceci : 

getContentPane ( ) . setLayout (new FlowLayout ( ) ) ; 

Voici un programme complet qui cree un bouton dans la fenetre graphique : 

import javax. swing.* ; import java.awt.* ; import j ava . awt . event . * ; 
class FenlBouton extends JFrame 
{ public FenlBouton () 

{ setTitle ("Premier bouton") ; setSize (300, 200) ; 

monBouton = new JButton ("ESSAI") ; 

getContentPane () .setLayout (new FlowLayout () ) ; 

getContentPane () .add (monBouton) ; 

} 

private JButton monBouton ; 

} 



1. Attention : si vous tentez 1' experience, les choses ne sont pas faciles a interpreter car la frontiere du bouton 
coincide avec celle de la fenetre et, pour l'instant, bouton et fenetre ont meme couleur de fond ! 

2. Vous verrez qu'on petit demander a ce gestionnaire de placer un composant soit au centre, soit sur l'un des 
quatre bords d'une fenetre. 
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public class Boutonl 

{ public static void main (String args[ ] ) 
{ FenlBouton fen = new FenlBouton ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Creation d'un bouton 



Remarques 

1 Ici, nous avons ajoute le bouton a la fenetre, avant son affichage par setVisible. Nous 
aurions aussi pu le faire apres ; dans ce cas, c'est l'ajout du bouton qui aurait provoque 
automatiquement un nouvel affichage de la fenetre. II est egalement possible de faire dis- 
paraitre temporairement un bouton par setVisible(false), puis de le faire reapparaitre par 
setVisible(true). 

2 Nous avons du importer le paquetage java.awt qui contient les classes Container et 
FlowLayout. D'une maniere generale, on peut eviter d'avoir a s'interroger sans cesse 
sur la repartition dans les paquetages des differentes classes utilisees dans les interfaces 
graphiques, en important systematiquement awt, awt. event, swing et swing. event. C'est 
ce que nous ferons generalement ; nous nous contenterons de signaler les cas ou 
d'autres paquetages seront necessaires. 

3 Si vous cherchez a aj outer le bouton a la fenetre elle-meme et non a son contenu, vous 
obtiendrez un message d'erreur tres explicite lors de 1' execution (il vous indiquera 
meme la modification a effectuer). 
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3.3 Gestion du bouton avec un ecouteur 

Un bouton ne peut declencher qu'un seul evenement correspondant a Taction de l'utilisateur 
sur ce bouton. Generalement, cette action est declenchee par un clic sur le bouton, mais elle 
peut aussi etre declenchee a partir du clavier (selection du bouton et appui sur la barre 
d'espace 1 )- 

La demarche exposee au paragraphe 2 pour gerer un clic souris dans une fenetre s' applique 
pour gerer Taction sur un bouton. II suffit simplement de savoir que T evenement qui nous 
interesse est Tunique evenement d'une categorie d'evenements nommee Action. II faudra 
done : 

• creer un ecouteur qui sera un objet d'une classe qui implemente T interface ActionListener ; 
cette derniere ne comporte qu'une methode nommee actionPerformed ; 

• associer cet ecouteur au bouton par la methode addActionListener (presente dans tous les 
composants qui en ont besoin, done en particulier dans la classe JButton). 

Voici comment nous pouvons adapter le programme precedent de facon qu'il affiche un mes- 
sage {clic sur bouton Essai) a chaque action sur le bouton : 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class FenlBouton extends JFrame implements ActionListener 

// Attention : ne pas oublier implements 
{ public FenlBouton () 

{ setTitle ("Premier bouton") ; 
setSize (300, 200) ; 
monBouton = new JButton ("ESSAI") ; 
getContentPane ( ) . setLayout (new FlowLayout ( ) ) ; 
getContentPane () .add (monBouton) ; 
monBouton . addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent ev) 

{ System. out. println ("action sur bouton ESSAI") ; 

} 

private JButton monBouton ; 

} 

public class Bouton2 

{ public static void main (String args[ ] ) 
{ FenlBouton fen = new FenlBouton ( ) ; 
fen . setvisible (true) ; 

} 

} 



1. Notez bien que Java ne vous permet pas de distinguer entre ces deux fajons d'actionner un bouton. 



Les bases de la programmation graphique 

Chapitre 12 



I 






I Auto J □ ft (ft ^ 




jxj 


AppAccelerator (Cm) 1.2.010 for Ja 
Copyright (c) 1997-1999 Inprise C 
action sur bouton ESSAI 
action sur bouton ESSAI 
action sur bouton ESSAI 
action sur bouton ESSAI 




1 



Gestion simple de I 'action sur un bouton 

Remarques 

1 Pour agir sur un composant a partir du clavier, celui-ci doit etre selectionne (on dit aussi 
qu'il doit avoir le focus). Un seul composant est selectionne a la fois dans une fenetre 
active et il est mis en evidence d'une certaine maniere (dans le cas d'un bouton, son 
libelle est encadre en pointille). On peut deplacer la selection d'un composant a un autre a 
l'aide des touches de tabulation. Mais ici, la fenetre ne contient qu'un seul composant qui 
se trouve selectionne en permanence. Aussi, une simple action sur la barre d'espace pro- 
voque Faffichage du message, au meme titre qu'un clic sur le bouton. 

2 La categorie d'evenements Action ne comportant qu'un seul evenement gere par la 
methode actionPerformed, il n'est pas necessaire ici de disposer d'une classe adapta- 
teur (et il n'en existe pas !). 

3 Comme la categorie Action ne comporte qu'un seul evenement, nous commettrons sou- 
vent l'abus de langage qui consiste a parler d'un evenement Action. 



4 Gestion de plusieurs composants 

Dans le paragraphe precedent, la fenetre graphique ne contenait qu'un seul bouton. II va de 
soi qu'elle peut en contenir plusieurs. En ce qui concerne leur creation et leur ajout a la fene- 
tre, il suffit de proceder comme nous l'avons fait auparavant. Si nous continuons d'utiliser le 
gestionnaire de type FlowLayout, les differents boutons seront affiches sequentiellement dans 
l'ordre de leur ajout ; cela nous conviendra pour 1' instant 1 . 



1. Avec le gestionnaire par defaut BorderLayout, tous les composants s'affichent par defaut au centre, de sorte 
que seul le dernier serait visible. On peut cependant fournir a la methode add une indication de position mais 
on reste neanmoins limite a cinq possibilites, done a cinq composants. 
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En ce qui concerne maintenant la gestion des actions sur ces differents boutons, on peut se 
contenter de ce qui a ete fait precedemment (tous les boutons afficheront alors le meme mes- 
sage). En fait, Java vous offre une tres grande liberte pour cette gestion puisque, comme nous 
l'avons deja dit, chaque evenement de chaque composant peut disposer de son propre objet 
ecouteur. De plus, chacun de ces ecouteurs peut etre ou non objet d'une meme classe ; on 
peut meme avoir une classe pour certains boutons et une autre classe pour d'autres... Bien 
entendu, le choix dependra du probleme a resoudre : il s'effectuera selon les traitements qu'il 
faudra reellement declencher pour chaque action et aussi en fonction des informations 
necessaires a leur accomplissement. 

Nous vous proposerons ici quelques situations qui vous permettront d'apprehender la 
richesse des possibilites de Java et qu'il vous sera facile de transposer a n'importe quel com- 
posant. Au passage, nous verrons comment regler les eventuels problemes d'idenfication 
d'un composant source d'un evenement en recourant aux methodes getSource et getAction- 
Command. 

Malgre leur ressemblance, nous vous conseillons de bien etudier ces differents programmes. 
Lors du developpement de vos propres applications, vous serez ainsi en mesure d'effectuer 
vos choix en toute connaissance de cause. 

4.1 La fenetre ecoute les boutons 

On peut faire de la fenetre Fobjet ecouteur de tous les boutons. Meme dans ce cas, plusieurs 
possibilites existent ; en effet, on peut : 

• prevoir exactement la meme reponse, quel que soit le bouton ; 

• prevoir une reponse dependant du bouton concerne, ce qui necessite de 1' identifier ; nous 
verrons qu'on peut le faire en utilisant Fune des methodes getSource ou getActionCom- 
mand. 

4.1.1 Tous les boutons declenchent la meme reponse 

Ici, on se contente de generaliser a tous les boutons ce qui a ete fait dans l'exemple 
precedent ; tous les boutons declenchent l'affichage du meme message. 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class Fen2Boutons extends JFrame implements ActionListener 
{ public Fen2Boutons () 

{ setTitle ("Avec deux boutons") ; 
setSize (300, 200) ; 

monBoutonl = new JButton ("Bouton A") ; 
monBouton2 = new JButton ("Bouton B") ; 
Container contenu = getContentPane ( ) ; 
contenu.setLayout(new FlowLayout ( ) ) ; 
contenu . add (monBoutonl ) ; 



Les bases de la programmation graphique 

Chapitre 12 



contenu . add (monBouton2 ) ; 

monBoutonl .addActionListener (this) ; //la fenetre ecoute monBoutonl 
monBouton2 .addActionListener (this) ; //la fenetre ecoute monBouton2 

} 

public void actionPerformed (ActionEvent ev) // gestion commune a 

{ System. out. println ("action sur un bouton") ; // tous les boutons 
} 

private JButton monBoutonl, monBouton2 ; 

} 

public class Boutonsl 

{ public static void main (String args[ ] ) 
{ Fen2Boutons fen = new Fen2Boutons ( ) ; 
fen . setvisible (true) ; 

} 

) 
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Exemple de fenetre ecoutant deux boutons 



Remarque 

Ici, nous pouvons voir clairement qu'un seul des deux boutons est selectionne a un 
moment donne ; sur l'exemple precedent, il s'agit du bouton B. 



4.1.2 La methode getSource 

Ici, nous continuons d' employer une seule methode pour les deux boutons. Mais nous faisons 
appel a la methode getSource (presente dans toutes les classes evenements, done dans 
ActionEvent) ; elle fournit une reference (de type Object) sur l'objet ayant declenche l'evene- 
ment concerne. 
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import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class Fen2Boutons extends JFrame implements ActionListener 
{ 

public Fen2Boutons () 
{ setTitle ("Avec deux boutons") ; 
setSize (300, 200) ; 

monBoutonl = new JButton ("Bouton A") ; 
monBouton2 = new JButton ("Bouton B") ; 
Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayout ( ) ) ; 
contenu . add (monBoutonl ) ; 
contenu . add (monBouton2 ) ; 
monBoutonl .addActionListener (this) ; 
monBouton2 .addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent ev) 
{ if (ev.getSource () == monBoutonl) 

System. out. println ("action sur bouton numero 1") ; 
if (ev.getSource () == monBouton2) 

System. out. println ("action sur bouton numero 2") ; 

} 

private JButton monBoutonl, monBouton2 ; 

} 

public class Boutons2 

{ public static void main (String args[ ] ) 
{ Fen2Boutons fen = new Fen2Boutons ( ) ; 
fen. setvisible (true) ; 

} 

} 
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Remarques 



1 Nous avons du utiliser une instruction ;/ pour connaitre le bouton concerne. Une telle 
demarche n'est pas toujours adaptee a un grand nombre de boutons (ou de composants). 
En outre, elle necessite de conserver les references aux composants (ce qui ne sera pas 
toujours le cas). 

2 Notez la comparaison entre un objet de type Object (ev.getsourcef)) et un objet de type 
JButton {monBoutonl ou tnonBoutotiZ) . Elle met theoriquement en jeu une conversion 
implicite du type JButton en un type ascendant Object, conversion qui ne modifie pas la 
reference correspondante. 

4.1.3 La methode getActionCommand 

La methode getSource permet d' identifier la source d'un evenement et elle a le merite de 
s'appliquer a tous les evenements generes par tous les composants. 

II existe une autre technique d' identification d'une source d'evenements qui ne s'applique 
qu'aux evenements de la categorie Action. Elle se fonde sur le fait que tout evenement de 
cette categorie est caracterise par ce que Ton nomme une chaine de commande, c'est-a-dire 
une chaine de caracteres (String) associee a Faction. Par defaut, dans le cas d'un bouton, la 
chaine de commande n'est rien d'autre que l'etiquette de ce bouton. 

La methode getActionCommand, presente uniquement dans la classe ActionEvent, permet 
d'obtenir la chaine de commande associee a la source d'un evenement. 

Dans l'exemple ci-dessous, nous continuons d' employer une seule methode pour nos deux 
boutons, que nous identifions cette fois a l'aide de getActionCommand : 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class Fen2Boutons extends JFrame implements ActionListener 
{ public Fen2Boutons () 

{ setTitle ("Avec deux boutons") ; 
setSize (300, 200) ; 

monBoutonl = new JButton ("Bouton A") ; 
monBouton2 = new JButton ("Bouton B") ; 
Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayout ( ) ) ; 
contenu. add (monBoutonl) ; 
contenu . add (monBouton2 ) ; 
monBoutonl . addActionListener (this) ; 
monBouton2 . addActionListener (this) ; 
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public void actionPerformed (ActionEvent ev) 
{ String nom = ev . getActionCommand ( ) ; 

System. out. println ("Action sur bouton " + nom) ; 

} 

private JButton monBoutonl, monBouton2 ; 



public class Boutons3 

{ public static void main (String args[ ] ) 
{ Fen2Boutons fen = new Fen2Boutons ( ) ; 
fen . setvisible (true) ; 

} 

} 



H 



i Avec deux boutons 



Boutons3 [Application Java] C:\Program Files\Java\jdkl ,5.0\bin\javaw.exe (13 nov. 2005 18:13:50) 
Action sur bouton Bouton A 
Action sur bouton Bouton b| 
Action sur bouton Bouton B 
Action sur bouton Bouton A 
Action sur bouton Bouton A 



Bouton A 



Bouton B 



B % 

§ .classpath a 
1 .project 
u Boutons3.cla 
,J Boutons3.jav v 
< > 



Exemple d 'utilisation de la methode getActionCommand 



Remarques 

1 Par defaut, la chame de commande associee a un bouton est son etiquette. On peut en 
imposer une autre, en recourant a la methode setActionCommand de la classe JButton, par 
exemple : 

monBoutonl . setActionCommand ("Premier type"); 

Cette possibilite peut s'averer interessante dans un programme qui doit etre adapte a 
differentes langues : le libelle peut etre adapte a la langue, tandis que la chaine de com- 
mande peut rester la meme. 

Les composants qui disposent d'une chame de commandes sont les boutons, les cases a 
cocher, les boutons radio et les options de menu. 

2 La methode getComponent fournit la meme reference que getSource, mais du type 
Component. Ainsi, e.getComponentf ) est equivalent a (Component)e.getSource(). 
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3 En toute rigueur, la classe AbstractButton (done ses classes derivees dont la classe 
JButton) dispose egalement d'une methode getActionCommand fournissant egalement 
la chame de commande associee a l'objet. 



4.2 Classe ecouteur differente de la fenetre 

Dans les exemples precedents, nous avons fait de la fenetre l'objet ecouteur de ses boutons. 
Voyons maintenant des situations dans lesquelles l'ecouteur est different de la fenetre. Parmi 
les nombreuses possibilites existantes, nous en examinerons deux : 

• une classe ecouteur par bouton, 

• une seule classe ecouteur pour tous les boutons. 

4.2.1 Une classe ecouteur pour chaque bouton 

Ici, nous prevoyons done que chaque bouton possede sa propre classe ecouteur. Cela permet 
ainsi de disposer d'une methode actionPerformed specifique a chaque bouton. 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class Fen2Boutons extends JFrame 
{ public Fen2Boutons () 

{ setTitle ("Avec deux boutons") ; 
setSize (300, 200) ; 

monBoutonl = new JButton ("Bouton A") ; 
monBouton2 = new JButton ("Bouton B") ; 
Container contenu = getContentPane ( ) ; 
contenu.setLayout(new FlowLayout ( ) ) ; 
contenu. add (monBoutonl) ; 
contenu . add (monBouton2 ) ; 

EcouteBoutonl ecoutl = new EcouteBoutonl () ; 
EcouteBouton2 ecout2 = new EcouteBouton2 ( ) ; 
monBoutonl . addActionListener (ecoutl) ; 
monBouton2 . addActionListener (ecout2) ; 

} 

private JButton monBoutonl, monBouton2 ; 

} 

class EcouteBoutonl implements ActionListener 
{ public void actionPerformed (ActionEvent ev) 

{ System. out. println ("action sur bouton 1") ; 

} 

} 
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class EcouteBouton2 implements ActionListener 
{ public void actionPerformed (ActionEvent ev) 

{ System. out. println ("action sur bouton 2") ; 

} 

} 

public class Boutons4 

{ public static void main (String args[ ] ) 
{ Fen2Boutons fen = new Fen2Boutons ( ) ; 
fen . setvisible (true) ; 

} 

) 



Boutons4 [Application Java] C:\Prograrn Files\Java\ jdkl, 5, 0\bin\iavaw.exe (1 J nov. 200 5 18:17:36) 



Avec deux boutons _ |n|jX 



action sur bouton 1 
action sur bouton 1 
action sur bouton 2 
action sur bouton 1 
action sur bouton 2 



Bouton A 



Bouton B 



Exemple d' utilisation d'une classe ecouteur par objet bouton 

Remarques 

1 Aucun probleme d' identification de bouton ne se pose ici puisqu'il est automatiquement 
regie par le choix de la methode actionPerformed. 

2 Dans certains cas, l'objet ecouteur peut avoir besoin d' informations en provenance de 
1' objet fenetre. Ce probleme (classique) de communication entre objets de classes diffe- 
rentes peut se regler de plusieurs facons. On peut par exemple prevoir des methodes 
d'acces appropriees dans la classe MaFenetre, ou munir la classe ecouteur d'un cons- 
tructeur auquel on fournit 1' information voulue. 

4.2.2 Une seule classe ecouteur pour les deux boutons 

On peut aussi utiliser une seule classe ecouteur pour les deux boutons, ce qui signifie que Ton 
ne dispose plus que d'une seule methode actionPerformed commune aux deux boutons. 

Pour identifier le bouton concerne au sein de cette methode, on peut toujours recourir a 
getActionCommand ; l'emploi de getSource est generalement peu aise. 

Mais on peut aussi prevoir d'associer un objet ecouteur different a chaque bouton (attention : 
cette fois, la classe est commune, seuls les objets different) et s' arranger pour que chacun 
possede un champ permettant de 1'identifier. Ce champ peut tout a fait etre initialise a la 
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construction, par exemple a partir d'une information fournie lors de l'appel du constructeur 
de Fobjet ecouteur. 

Voici un exemple, dans lequel nous conservons dans chaque ecouteur un numero fourni a la 
construction (nous avons choisi artificiellement les valeurs 10 et 20) : 



import javax. swing.* ; import java.awt.* ; import java.awt. event.* ; 
class Fen2Boutons extends JFrame 
{ public Fen2Boutons () 

{ setTitle ("Avec deux boutons") ; setSize (300, 200) ; 

monBoutonl = new JButton ("Bouton A") ; 

monBouton2 = new JButton ("Bouton B") ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayout ( ) ) ; 

contenu. add (monBoutonl) ; contenu . add (monBouton2 ) ; 

EcouteBouton ecoutl = new EcouteBouton (10) ; 

EcouteBouton ecout2 = new EcouteBouton (20) ; 

monBoutonl . addActionListener (ecoutl) ; monBouton2.addActionListener (ecout2) ; 

} 

private JButton monBoutonl, monBouton2 ; 

) 

class EcouteBouton implements ActionListener 
{ public EcouteBouton (int n) 
{ this.n = n ; 

} 

public void actionPerformed (ActionEvent ev) 

{ System. out .println ("action sur bouton " + n) ; 

} 

private int n ; 

} 

public class Boutons 5 

{ public static void main (String args[ ] ) 

{ Fen2Boutons fen = new Fen2Boutons ( ) ; fen. setvisible (true) ; 
} 

) 



Boutons5 [Application Java] C:\Program Files\ Java\ jdkl . 5. 0\bm\javaw , exe (13 nov. 2005 18:20:50) 
action sur bouton 10 



action sur bouton 10 
action sur bouton 20 
action sur bouton 20 
action sur bouton 10 



Avec deux boutons 





Bouton A 




Bouton B 



Unix 



B % 

1 .dasspath <V 
| .project 
im Boutons5,cla 
J I Boutons5,jav v 
< > 



Exemple d' utilisation d'un objet ecouteur (d'une mime classe) par bouton 
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4.3 Dynamique des composants 

Dans les exemples precedents, les boutons etaient crees en meme temps que la fenetre et ils 
restaient affiches en permanence. II en ira souvent ainsi. Neanmoins, il faut savoir qu'on peut, 
a tout instant : 

• creer un nouveau composant, 

• supprimer un composant, 

• desactiver un composant, c'est-a-dire faire en sorte qu'on ne puisse plus agir sur lui ; dans 
le cas d'un bouton, cela revient a le rendre inoperant, 

• reactiver un composant desactive. 

On cree un nouveau composant comme nous avons deja appris a le faire : creation de l'objet 
et ajout au contenu de la fenetre par la methode add. Cependant, si cette operation est effec- 
tuee apres 1'affichage de la fenetre, il faut forcer le gestionnaire de mise en forme a recalculer 
les positions des composants dans la fenetre, de l'une des facons suivantes 

• en appelant la methode revalidate pour le composant concerne, 

• en appelant la methode validate pour son conteneur. 

On supprime un composant avec la methode remove de son conteneur. La encore, un appel a 
validate est necessaire (ici, il n'est plus possible d'appeler revalidate pour le composant qui 
n'existe plus). 

L' activation d'un composant de reference compo se fait simplement par : 

compo . setEnabled (false) ; // le composant est desactive 
La reactivation du meme composant se fait par : 

compo . setEnabled (true) ; // le composant est reactive 
On peut savoir si un composant donne est active ou non a l'aide de : 

compo . isEnabled ( ) ; // true si le composant est active 

Notez bien que toutes ces operations s'appliquent a n'importe quel composant, et pas seule- 
ment aux boutons 1 . 

Exemple 1 

Voici un programme qui cree dynamiquement des boutons dans une fenetre. Chaque action 
sur un bouton d'etiquette CREATION BOUTON cree un nouveau bouton qui s'ajoute aux 
anciens. 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 



1 . En annexe F, vous trouverez les en-tetes exacts des methodes evoquees. 
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class FenBoutonsDyn extends JFrame 
{ public FenBoutonsDyn () 

{ setTitle ("Boutons dynamiques") ; 
setSize (500, 150) ; 

Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayout () ) ; 
crBouton = new JButton ("CREATION BOUTON") ; 
contenu . add ( crBouton ) ; 

EcoutCr ecoutCr = new EcoutCr (contenu) ; 
crBouton. addActionListener (ecoutCr) ; 

} 

private JButton crBouton ; 

} 

class EcoutCr implements ActionListener 
{ public EcoutCr (Container contenu) 

{ this. contenu = contenu ; 

} 

public void actionPerformed (ActionEvent ev) 
{ JButton nouvBout = new JButton ("BOUTON") ; 

contenu. add (nouvBout) ; 

contenu. validate () ; // pour recalculer 

} 

private Container contenu ; 

} 

public class BoutDyO 

( public static void main (String args[ ] ) 

{ FenBoutonsDyn fen = new FenBoutonsDyn () ; 
fen. setvisible (true) ; 

} 



^Boutons dynamiques 



CREATION BOUTON 



BOUTON 



BOUTON 



BOUTON 



BOUTON 



BOUTON 



Creation dynamique de boutons dans une fenetre 

Exemple 2 

Voici maintenant un programme qui affiche un nombre donne de boutons (defini par la cons- 
tante symbolique NBOUTONS). Chaque clic sur l'un des boutons : 

• le des active, 

• affiche Fetat (active/non active) de tous les boutons. 
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import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class FenBoutonsDyn extends JFrame implements ActionListener 
{ final int NB0UTONS=5 ; 

public FenBoutonsDyn () 

{ setTitle ("Activation/Desactivation") ; 
setSize (500, 150) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayout () ) ; 

tabBout = new JButtorf NBOOTONS] ; 

for (int i=0 ; KNB0U1ONS ; i++) 

{ tabBoutl i] = new JButton ("BOUTDN"+i) ; 

contenu. add (tabBoutl i] ) ; 

tabBout[ i] . addActionListener (this); 

} 

} 

public void actionPerformed (ActionEvent ev) 
{ System. out. print ("Etat BOUTONS = ") ; 

for (int i=0 ; KNBOUTONS ; i++) 

System. out. print (tabBoutl i] .isEnabledO + " ") ; 

System. out .println ( ) ; 

JButton source = (JButton) ev . getSource ( ) ; 
System. out. println ("on desactive le bouton : " 

+ source . getActionCommand ( ) ) ; 
source . setEnabled (false ) ; 

} 

private JButton tabBoutl ] ; 

} 

public class BoutDyl 

{ public static void main (String args[ ] ) 

{ FenBoutonsDyn fen = new FenBoutonsDyn () ; 
fen. setvisible (true) ; 

} 

} 



1 HI Activation/Desactivation 


■ - n|x| 




BOUTONO 


BOUTON2 


BOUTON4 













Etat BOUTONS = true true true true true 
on desactive le bouton : BOUTON1 
Etat BOUTONS = true false true true true 
on desactive le bouton : BOUTON3 



Exemple d' utilisation des methodes isEnabled et setEnabled 
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Remarqi 



ue 



On peut appliquer la methode setVisible (false) a un composant pour le rendre invisible. 
Cette action ne force pas le gestionnaire a recalculer la position des composants ; le com- 
posant invisible continue d'occuper une place vide jusqu'a un eventuel nouveau calcul... 



Java permet de dessiner sur n'importe quel composant en utilisant des methodes de dessin. 
Cependant, si vous utilisez directement ces methodes, vous obtiendrez le dessin attendu mais 
il disparaitra en totalite ou en partie des que la fenetre contenant le composant aura besoin 
d'etre reaffichee, comme cela peut arriver en cas de modification de sa taille, de deplacement, 
de restauration apres une reduction en icone... 

Vous avez pu constater que ce probleme ne concerne pas les composants que vous placez 
dans une fenetre car la permanence de leur affichage est prise en compte automatiquement 
par Java 1 . Pour obtenir cette permanence pour vos propres dessins, il est necessaire de placer 
les instructions de dessin dans une methode particuliere du composant concerne, nommee 
paintComponent. Cette methode est automatiquement appelee par Java chaque fois que le 
composant a besoin d'etre dessine ou redessine. 

Cependant, une exception a lieu pour le "composant de premier niveau" qu'est la fenetre de 
classe JFrame (ou derivee). Sa methode de dessin, qui se nomme paint et non paintCompo- 
nent, ne jouit pas exactement des memes proprietes que paintComponent, notamment en ce 
qui concerne les appels automatiques des methodes de dessin des composants inclus dans la 
fenetre. Ces differences se justifient essentiellement par l'introduction dans Java 2 de compo- 
sants dits swing et par la distinction entre composant lourd (lie au systeme d' exploitation) et 
composant leger 2 (independant du systeme et totalement portable). 

Mais il n'est pas necessaire d'entrer dans des considerations techniques et historiques pour 
bien dessiner avec Java 2. La demarche la plus raisonnable consiste simplement a eviter de 
dessiner directement dans une fenetre {JFrame), et a lui preferer ce qu'on nomme un pan- 
neau, c'est-a-dire un objet de classe JPanel (ou derivee). On peut toujours y parvenir, quitte a 
ce qu'une fenetre ne contienne finalement qu'un seul panneau. Avant de realiser notre pre- 
mier dessin, nous allons done apprendre a creer un panneau. 



1 . Le cas de composants ajoutes dynamiquement constitue bien une exception a cette prise en charge automati- 
que. Mais il ne s'agit plus d'un probleme de dessin proprement dit, mais simplement de prise en compte des 
nouveaux composants par le gestionnaire de mise en forme (ce probleme se resout en appelant validate). 

2. JFrame est un composant lourd. II en ira de meme de JDialog et de JApplet. Les autres composants swing 
(Jxxxx) sont des composants legers. 



5 Premier dessin 
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5.1 Creation d'un panneau 

Jusqu'ici, nous avons ete amenes a placer des composants dans une fenetre JFrame. On dit 
que la fenetre est un conteneur, c'est-a-dire un objet susceptible de contenir d'autres compo- 
sants. Nous avons aussi rencontre des composants comme les boutons qui, quant a eux, ne 
peuvent pas en contenir d'autres ; on les nomme parfois composants atomiques. Mais il 
existe des composants intermediaires qui peuvent etre contenus dans un conteneur, tout en 
contenant eux-memes d'autres composants. C'est precisement le cas des panneaux. 

Cependant, nous nous contenterons pour l'instant d'utiliser un panneau sans y introduire 
d'autres composants, et ceci afin de pouvoir y dessiner. 

Un panneau est une sorte de "sous-fenetre", sans titre ni bordure. II s'agit done d'un simple 
rectangle qui, tant qu'on ne lui donne pas de couleur specifique n'est guere visible. Contrai- 
rement a une fenetre, un panneau ne peut pas exister de facon autonome. II doit obligatoire- 
ment etre associe par la methode add a un autre conteneur, generalement une fenetre 1 (plus 
exactement a son contenu). 

Voici comment creer un tel conteneur et l'ajouter a une fenetre de classe MaFenetre : 

class MaFenetre extends JFrame 
{ public MaFenetre () // constructeur 

{ 

panneau = new JPanel () 

getContentPane ( ) . add (panneau) ; 

} 

private JPanel panneau ; 

} 

Si nous introduisons cette classe dans un programme qui affiche simplement une fenetre de 
type MaFenetre, nous ne verrons pas grand-chose. En effet, d'une part notre panneau n'a pas 
de bordure, d' autre part sa couleur de fond est, par defaut, celle du conteneur auquel on Fa 
attache. 

On peut cependant modifier la couleur du panneau a l'aide de la methode nommee setBac- 
kground. II suffit pour cela de savoir qu'elle recoit en argument un objet de type Color et que 
cette classe dispose de quelques constantes predefinies correspondant a quelques couleurs 
usuelles ; par exemple Color.yellow pour jaune. 

Si Ton procede ainsi, on decouvrira que toute la fenetre est peinte en jaune. Cela est du, la 
encore, au gestionnaire de mise en forme BorderLayout utilise par defaut par JFrame. Nous 
verrons plus tard comment imposer des dimensions au panneau (en utilisant d'autres gestion- 
naires), mais pour l'instant, cette situation nous conviendra. 

A titre recapitulatif, voici un petit programme complet qui cree un panneau jaune : 



1 . Mais rien ne vous empeche de placer un panneau dans un autre panneau. 



Les bases de la programmation graphique 

Chapitre 12 



import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Fenetre = panneau jaune") ; 

setSize (300, 150) ; 

paneau = new JPanel ( ) ; 

paneau . setBackground (Color . yellow) ; 

getContentPane ( ) . add (paneau) ; 

} 

private JPanel paneau ; 

} 

public class Paneau 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 



^Fenetre = paneau jaune I 



Creation d'un panneau jaune occupant toute la fenetre 

5.2 Dessin dans le panneau 

Comme nous Favons dit en introduction, pour obtenir un dessin permanent dans un compo- 
sant, il faut redefinir sa methode paintComponent, dont on sait qu'elle sera appelee chaque 
fois que le composant aura besoin d'etre redessine. 

Notons deja que, puisqu'il s'agit de redefinir une methode de la classe JPanel, il nous faut 
obligatoirement faire de notre panneau un objet d'une classe derivee de JPanel. D'autre part, 
la methode paintComponent a redefinir possede cet en-tete : 

void paintComponent (Graphics g) 

Son unique argument est ce que Ton nomme un contexte graphique 1 . II s'agit d'un objet de 
classe Graphics (ou derivee) qui sert d' intermediate entre vos demandes de dessins et leur 



1. C'est ce qu'on appelle un contexte d'affichage en programmation Windows, un contexte graphique en pro- 
grammation XI 1. 
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realisation effective. Cette classe encapsule toutes les informations qui permettront, au bout 
de compte, de travailler avec une implementation donnee (systeme et materiel). Elle dispose 
de toutes les methodes voulues pour dessiner sur le composant associe. Elle gere egalement 
des parametres courants tels que la couleur de fond, la couleur de trait, le style de trait, la 
police de caracteres, la taille des caracteres... 

Nous supposerons ici que nous souhaitons simplement dessiner un trait dans notre panneau. 
II nous suffit pour cela d'appeler pour l'objet g une methode nommee drawLine, par 
exemple : 

g. drawLine (15, 10, 100, 50) ; // trace un trait 

// du point de coordonnees 15, 10 

// au point de coordonnees 15+100, 10+50 

Rappelons que les coordonnees s'expriment en pixels et qu'elles sont relatives au coin supe- 
rieur gauche du composant. 

Mais nous ne devons pas nous contenter de placer cette seule instruction dans paintCompo- 
nent. II nous faut aussi appeler explicitement la methode paintComponent de la classe ascen- 
dante JPanel, en procedant comme nous Favons appris au chapitre 8 : 

super .paintComponent (g) ; 

En effet, cette methode se trouve appelee tant qu'on ne la redefinit pas. Or c'est elle qui rea- 
lise le dessin du composant. Certes, dans le cas d'un panneau, ce dessin se resume a peu de 
choses (en fait, la couleur de fond 1 )- Mais, dans le cas d'un bouton, il s'agit du dessin com- 
plet du bouton (auquel vous pouvez ajouter votre dessin personnalise). 

Notez bien qu'il faut appeler super.paintComponent, avant de realiser vos propres dessins. 
Dans le cas contraire, le travail de la methode de 1' ascendant viendrait surcharger votre dessin 
(en general, vous ne le verriez plus !). 

Voici un programme complet qui affiche un trait dans un panneau jaune occupant toute la 
fenetre : 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Essai dessins") ; 

setSize (300, 150) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

pan. setBackground (Color. yellow) ; // couleur de fond = jaune 

} 

private JPanel pan ; 

) 



1. Pour vous en convaincre, experimentez le programme suivant en supprimant cette instruction. 
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class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

g.drawLine (15, 10, 100, 50) ; 

} 

} 

public class PremDes 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 




Dessin d'un trait dans un panneau jaune occupant toute la fenetre 

Remarques 

1 Nous vous conseillons de verifier que le dessin ainsi obtenu est bien permanent. Pour 
cela, deplacez la fenetre, retaillez-la, reduisez-la en icone avant de la faire reapparaitre... 

2 On peut dessiner dans une fenetre, independamment de sa taille courante. Vous pouvez 
le verifier en modifiant le programme precedent pour qu'il trace un trait plus grand (par 
exemple g.drawLine (15, 10, 500, 400) puis en agrandissant manuellement la fenetre 
apres le lancement du programme. Cette possibilite permet de redefinir la methode 
paintComponent, sans avoir a s'interroger sur la taille effective de la fenetre. 

5.3 Forcer le dessin 

Jusqu'ici, notre dessin etait defini des le debut du programme et il n'etait pas modifie par la 
suite. Souvent, on aura besoin de dessiner a la suite d'une action de Futilisateur, par exemple 
sur un bouton. Dans ce cas, on n'aura pas interet a dessiner directement dans un panneau 1 
pour les memes raisons que precedemment : le dessin disparaitrait ou serait endommage lors 
de certaines actions sur la fenetre. En fait, la bonne demarche consiste la encore a placer dans 




1. Pour l'instant, vous ne savez d'ailleurs pas comment faire pour y parvenir... 
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paintComponent les instructions de dessin correspondantes. Toutefois, en general, cela ne 
sera pas totalement suffisant car le resultat n'apparaitra que lorsque paintComponent sera 
effectivement appelee, c'est-a-dire seulement quand le panneau aura besoin d'etre redessine. 
II faudra en outre forcer l'appel premature de paintComponent par l'appel de la methode 
repaint. 

Voici un exemple dans lequel nous disposons de deux boutons. Le premier permet de dessi- 
ner un cercle dans un panneau, le second de dessiner dans le meme panneau un rectangle qui 
remplace le cercle qui s'y trouve eventuellement. Au demarrage du programme, rien ne 
s'affiche dans le panneau. 

Nous conservons pour la fenetre le gestionnaire de mise en forme par defaut nomme Border- 
Layout. Jusqu'ici, nous ne l'avons utilise que pour introduire un seul composant dans la fene- 
tre, et nous avons dit qu'alors il occupait tout Fespace disponible. En fait, comme son nom le 
laisse entendre, ce gestionnaire permet de disposer des composants non seulement au centre, 
mais aussi sur les quatre bords de la fenetre. II suffit pour cela de fournir a la methode add un 
argument de la forme "North", "South", "East" ou "West". Cela nous suffira ici : nous place- 
rons l'un des boutons en haut, l'autre en bas et le panneau au centre (il occupera en fait 
l'espace laisse libre). 

import javax. swing.* ; 

import java.awt.* ; import java.awt. event.* ; 

class MaFenetre extends JFrame implements ActionListener 

{ MaFenetre ( ) 

{ setTitle ("Exemple appel repaint") ; 
setSize (300, 200) ; 

Container contenu = getContentPane ( ) ; 

// creation paneau pour le dessin 
pan = new Paneau ( ) ; 
pan . setBackground (Color. cyan) ; 
contenu. add (pan) ; 

// creation bouton "rectangle" 
rectangle = new JButton ("Rectangle") ; 
contenu . add ( rectangle , "North" ) ; 
rectangle . addActionListener (this) ; 

// creation bouton "ovale" 
ovale = new JButton ("Ovale") ; 
contenu. add (ovale, "South") ; 
ovale. addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent ev) 
{ if (ev.getSource () == rectangle) pan . setRectangle ( ) ; 
if (ev.getSource () == ovale) pan . setOvale ( ) ; 

pan . repaint ( ) ; // pour forcer la peinture du paneau des maintenant 

} 

private Paneau pan ; 

private JButton rectangle, ovale ; 

} 



Les bases de la programmation graphique 

Chapitre 12 



class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

if (ovale) g.drawOval (80, 20, 120, 60) ; 

if (rectangle) g.drawRect (80, 20, 120, 60) ; 

} 

public void setRectangle ( ) (rectangle = true ; ovale = false ; } 
public void setOvaleO (rectangle = false ; ovale = true ; } 
private boolean rectangle = false, ovale = false ; 

} 

public class Repaint 

( public static void main (String args[ ] ) 
( MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 





Exemple appel repaint 


Rectangle 


1 






Ovale 





Exemple d' utilisation de repaint pour forcer le dessin dans un panneau 

5.4 Ne pas redefinir inutilement paintComponent 

Ici, nous avons veritablement dessine sur un panneau. Mais on peut aussi agir sur la couleur 
d'un composant, y afficher du texte... 

En Java, on regroupe generalement toutes ces actions sous Fun des termes dessin ou peinture 
(en anglais painting). II faut cependant noter que la redefinition de paintComponent n'est 
utile que si le dessin voulu ne peut pas etre produit directement par Java. Par exemple, pour 
changer le libelle d'un bouton, on peut appeler la methode setText a n'importe quel moment, 
et pas necessairement dans paintComponent. II en va de meme pour la couleur de fond ou 
d'avant plan (elle est utilisee pour ecrire ou dessiner sur un composant et elle peut etre modi- 
fiee par setForeground). Dans ces differents cas, ce travail sera effectue par la methode paint- 
Component de la classe de base et il ne sera pas necessaire de la surdefinir (mais on pourra 
bien sur le faire si cela s'avere utile par ailleurs). 
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5.5 Notion de rectangle invalide 

Nous avons vu que lorsqu'un composant a besoin d'etre repeint, Java appelle automatique- 
ment sa methode paintComponent. Cependant, il peut etre amene a limiter le dessin a la seule 
partie (rectangulaire) du composant qui s'est trouvee endommagee ; par exemple, apres 
qu'un menu se soit affiche sur une fenetre et qu'il ait ete efface, Java provoque automatique- 
ment le dessin de la fenetre, en se limitant a F emplacement ou est apparu le menu. 

En general, ce mecanisme sera satisfaisant. Dans les rares cas oil il ne le sera pas, il faudra 
forcer le dessin de l'integralite du composant concerne par appel de repaint. Un tel besoin 
pourrait apparaitre par exemple lorsqu'une option de menu modifie la couleur d'un dessin 
affiche dans une fenetre : si Ton ne force pas l'appel de repaint, on constatera que seule la 
partie du dessin recouverte par le menu verra sa couleur modifiee. 

6 Dessiner a la volee 

Jusqu'ici, nous avons dit que les operations de dessin (autres que celles prises en charge par 
Java) devaient etre realisees dans une methode paintComponent, quitte a en forcer l'appel par 
repaint. 

La plupart du temps, cette demarche impliquera des echanges d' informations entre l'objet 
appelant repaint et la methode paintComponent. Parfois meme, il faudra conserver les infor- 
mations permettant de reconstituer tout un dessin qui aura pu etre obtenu suite a de nombreu- 
ses actions de l'utilisateur. 

Dans certains cas, on pourra alors etre tente de dessiner a la volee (ou en direct), c'est-a-dire 
au fur et a mesure des actions de l'utilisateur. Cette demarche est applicable en Java mais a 
condition d' accepter que la permanence des dessins ne soit plus assuree. Elle doit done etre 
reservee a des essais ou a des situations particulieres. 

Pour dessiner a la volee sur un composant, il est necessaire : 

• d'obtenir un contexte graphique pour ce composant en utilisant sa methode getGraphics 
(paintComponent fournissait automatiquement un contexte graphique en argument), 

• d'appliquer les operations de dessin a ce contexte graphique comme auparavant, 

• de liberer le contexte graphique par dispose, afin d'eviter d'encombrer inutilement la me- 
moire (paintComponent realisait automatiquement cette liberation). 

A titre d' exemple, voici un programme qui utilise cette demarche pour afficher un petit carre 
a l'emplacement de chaque clic dans une fenetre (en fait, un panneau). Les instructions de 
dessin ont ete placees directement dans la mehode mouseClicked. 



import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* 
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class MaFenetre extends JFrame 
{ MaFenetre () 

{ setTitle ("Traces de dies") ; 

setSize (300, 150) ; 

pan = new JPanel ( ) ; 

getContentPane ( ) . add (pan) ; 

pan.addMouseListener (new EcouteClic (pan) ) ; 

} 

private JPanel pan ; 



class EcouteClic extends MouseAdapter 
{ public EcouteClic (JPanel pan) 
{ this. pan = pan ; 

} 

public void mouseClicked (MouseEvent e) 
{ int x = e . getX ( ) , y = e . getY ( ) ; 

Graphics g = pan . getGraphics ( ) ; 

g.drawRect (x, y, 5, 5) ; 

g . dispose ( ) ; 

} 

private JPanel pan ; 

} 

public class TrClicsl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 




Dessin a la volee dans un panneau (traces de dies) 



A titre indicatif, voici comment il aurait fallu proceder pour rendre ce dessin permanent. 
Notamment, nous aurions du conserver les differentes coordonnees de tous les clics pour 
pouvoir les prendre en compte dans paintComponent. Nous avons utilise ici deux tableaux de 
taille 100 ; au dela de ce nombre, les clics ne sont plus pris en compte. 
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import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Traces de dies") ; 

setSize (300, 150) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private Paneau pan ; 

} 

class Paneau extends JPanel 
{ final int MAX = 100 ; 
public Paneau () 

{ abs = new int[ MAX] ; ord = new int[ MAX] ; 
nbclics = 0 ; 

addMouseListener (new MouseAdapter ( ) 

{ public void mouseClicked (MouseEvent e) 
{ if (nbclics < MAX) 

{ abs[ nbclics] = e . getx ( ) ; 
ord[ nbclics] = e.getYO ; 
nbclics+l ; 
repaint ( ) ; 

} 

} 

} ) ; 

} 

public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 

for (int i = 0 ; i < nbclics ; i++) 
g.drawRect (abs[ i] , ord[ i] , 5, 5) ; 

} 

private int abs[ ] , ord[ ] ; 
private int nbclics ; 

} 

public class TrClics2 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 



Traces permanentes de dies 
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7 Gestion des dimensions 

Jusqu'ici, nous nous sommes contentes de fixer une taille pour la fenetre principale et nous 
avons laisse Java s'occuper du reste. Nous allons maintenant examiner comment Java nous 
permet de connaitre les dimensions des composants ou d'agir sur elles. Nous verrons : 

• comment connaitre la taille de l'ecran de Futilisateur, ce qui peut permettre d'adapter en 
consequence la taille d'une fenetre, 

• comment connaitre la taille d'un composant a un instant donne (fenetre, panneau, bouton...), 

• comment imposer des dimensions a un composant. 



7.1 Connaitre les dimensions de l'ecran 

La methode getScreenSize de la classe utilitaire Toolkit (du paquetage java.awt) fournit les 
dimensions de l'ecran sous la forme d'un objet de type Dimension (lequel contient en fait 
deux champs publics nommes height et width). Cette methode s' applique a un objet de type 
Toolkit, contenant les informations relatives a votre environnement et que vous devez d'abord 
creer explicitement a l'aide d'une methode statique getDef aultToolkit de cette meme classe 
Toolkit. Voici par exemple comment obtenir dans deux variables nominees haut et larg les 
dimensions de l'ecran, et ce depuis n'importe quel point du programme : 

Toolkit tk = Toolkit. getDef aultToolkit () ; 
Dimension dimEcran = tk. getScreenSize () ; 
larg = drmEcran . width ; 
haut = drmEcran . height ; 

Voici par exemple comment imposer dans le constructeur d'une fenetre que celle-ci ait des 
dimensions egales a la moitie de celles de l'ecran : 

class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Exemple taille fenetre") ; 

Toolkit tk = Toolkit. getDef aultToolkit () ; 

Dimension dimEcran = tk. getScreenSize () ; 

int larg = dimEcran. width ; 

int haut = dimEcran . height ; 

setSize (larg/2, haut/2) ; 

} 

) 



7.2 Connaitre les dimensions d'un composant 

A tout instant, on peut connaitre les dimensions d'un composant quelconque a l'aide de la 
methode getSize, laquelle fournit egalement un objet de type Dimension. 

Dans le programme du paragraphe 5.3, les dimensions des dessins etaient fixes. Voici com- 
ment nous pourrions modifier la methode paintComponent pour que les dimensions des des- 
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sins s'adaptent a celles du panneau (nous prevoyons une marge de 10 pixels sur les bords). Le 
programme complet figure sur le site Web d'accompagnement sous le nom Repaint2.java. 

public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 

Dimension dim = getSizeO ; // on obtient les dimensions du panneau 

int larg = dim. width, haut = dim. height ; 

if (ovale) g.drawOval (10, 10, larg-20, haut-20) ; 

if (rectangle) g.drawRect (10, 10, larg-20, haut-20) ; 

} 

7.3 Agir sur la taille d'un composant 

7.3.1 Agir sur la "taille preferentielle" d'un composant 

En fheorie, on peut toujours imposer une taille donnee a un composant en faisant appel a la 
methode setPreferredSize, par exemple {compo etant une reference a un composant) : 

compo.setPreferredSize (new Dimension (200, 100)) ; // largeur 200, hauteur 100 

Notez qu'il faut, la encore, utiliser un objet de type Dimension. 

Cependant, tous les gestionnaires de mise en forme ne font pas le meme usage de cette 
information. Ainsi, le gestionnaire par defaut des fenetres qu'est BorderLayout n'en tient 
pas compte. En revanche, le gestionnaire FlowLayout en tient compte dans la mesure du 
possible. De plus, pour un gestionnaire donne, l'effet pourra dependre de la nature du com- 
posant concerne. 

D'autre part, si cette taille est attribuee au composant avant l'affichage du conteneur auquel il 
est rattache, le gestionnaire de mise en forme en tiendra bien compte et l'affichage du conte- 
neur sera correct. En revanche, si on modifie cette taille par la suite, il faudra obliger le ges- 
tionnaire de mise en forme du conteneur a refaire ses calculs : 

• soit en appelant la methode validate pour le conteneur (de la meme facon que cet appel de- 
vait etre effectue en cas de modification du contenu d'un conteneur...), 

• soit en appelant la methode revalidate pour le composant. 

Voici un exemple dans lequel nous modifions dynamiquement la taille des boutons en fonc- 
tion des demandes de l'utilisateur formulees en fenetre console. II est accompagne de l'image 
de la fenetre initiale, d'un exemple de dialogue avec l'utilisateur et de l'image de la fenetre 
obtenue a la fin. 

import javax. swing.* ; 
import java.awt.* ; 

class Fen2Boutons extends JFrame 
{ final int NBOUTONS = 4 ; 

public Fen2Boutons () 

{ setTitle ("Modif taille boutons") ; 
setSize (300, 150) ; 



Les bases de la programmation graphique 

Chapitre 12 



Container contenu = getContentPane ( ) ; 
contenu.setLayout(new FlowLayout ( ) ) ; 
boutons = new JButton[ NEOUTONS] ; 
for (int i=0 ; KNBOUTONS ; 

{ boutonst i] = new JButton ("NUM "+i) ; 
contenu . add (boutonst i] ) ; 

} 

} 

public void setTaillBout (int num, int 1, int h) 
{ boutonst num] . setPreferredSize (new Dimension (1, h) ) ; 
boutons! num] . revalidate ( ) ; 

} 

private JButton boutons[ ] ; 



public class Boutail 

{ public static void main (String args[ ] ) 
{ Fen2Boutons fen = new Fen2Boutons ( ) ; 
fen . setvisible (true) ; 
int num, 1, h ; 
while (true) 

{ System. out. print ("num bouton : ") ; 
num = Clavier . lirelnt () ; 
System. out. print ("larg bouton : ") ; 
1 = Clavier. lirelnt () ; 
System. out. print ("haut bouton : ") ; 
h = Clavier. lirelnt () ; 
fen . setTaillBout (num, 1, h) ; 

} 

} 

) 
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Exemple de modification de taille de composants 

7.3.2 Agir sur la taille maximale ou la taille minimale d'un composant 

La encore, de meme qu'en theorie on pouvait agir sur la taille preferentielle d'un composant, 
on peut lui fixer une taille minimale avec setMinimumSize ou maximale avec setMaximum- 
Size. Ces deux methodes s'utilisent de la meme maniere que setPreferredSize. Par exemple, 
si compo est un composant, avec : 

compo.setMaximumSize (new Dimension (200, 50)) ; // largeur 200, hauteur 50 

La encore, l'effet dependra du gestionnaire et, eventuellement, du type du composant. 

Remarque 

On peut connaltre les valeurs des differents parametres de taille en recourant aux metho- 
des getPreferredSize, getMinimumSize, getMaximumSize (elle fournissent un resultat de 
type Dimension). Notez bien qu'il s'agit alors des valeurs choisies pour ces differents 
parametres et pas de la taille effective du composant a un moment donne, taille qui pourra 
toujours etre obtenue par getSize. 
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Les controles usuels 



II existe de nombreux composants susceptibles d'intervenir dans une interface graphique. 
Certains sont des conteneurs, c'est-a-dire qu'ils sont destines a contenir d'autres 
composants ; c'est notamment le cas des fenetres (JFrame) et des panneaux (JPanel). En 
revanche, certains composants ne peuvent pas en contenir d'autres ; c'est le cas des boutons. 
lis sont souvent nommes controles ou encore composants atomiques. 

Ce chapitre se propose d'etudier les principaux controles offerts par Swing 1 , a savoir : 

• les cases a cocher, 

• les boutons radio et la notion de groupe qui s'y attache, 

• les etiquettes, 

• les champs de texte, 

• les boites de listes, 

• les boites combinees. 

Nous vous conseillons d'etudier attentivement le comportement de ces differents composants 
avant de vous lancer dans le developpement de vos propres applications. L' experimentation 
de bon nombre des exemples de ce chapitre vous permettra de bien connaitre les evenements 
qu'ils sont susceptibles de produire, les methodes permettant de les exploiter, mais aussi leur 
manipulation par l'utilisateur du programme. 



1. II existe des controles specialises et assez sophistiques que nous n'etudierons pas ici ; citons, notamment : 
JTree, JTable, JEditorPane, JScrollPane, JSlider, JSpinner. 
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1 Les cases a cocher 

1.1 Generates 

La case a cocher permet a l'utilisateur d'effectuer un choix de type oui/non.. Elle est instan- 
ciee grace a la classe JCheckBox, dont le constructeur requiert obligatoirement un libelle qui 
sera toujours affiche a cote de la case pour en preciser le role : 

JCheckBox coche = new JCheckBox ("CASE") ; 

Comme tout composant, on ajoutera une case a cocher a un conteneur par la methode add, 
par exemple (on suppose ici qu'on est dans une methode d'un objet de type JFrame) : 

getContentPane () .add(coche) ; // ajoute 1' objet de reference coche 

// au contenu de la fenetre 
L' action de l'utilisateur sur une case a cocher se limite a la modification de son etat : passage 
de l'etat coche a l'etat non coche, ou l'inverse. Elle s'obtient comme pour un bouton soit par 
clic, soit par selection de la case et frappe d'espace. L'etat visuel de la case (cochee, non 
cochee) est gere automatiquement par les methodes de la classe JCheckBox. 

Par defaut, une case a cocher est construite dans l'etat non coche. On peut lui imposer l'etat 
coche en utilisant une autre version de constructeur, comme dans : 

JCheckBox coche = new JCheckBox ("CASE", true) ; 

Notez que l'appel JCheckBox ("CASE") est equivalent a l'appel JCheckBox ("CASE", false). 

1 .2 Exploitation d'une case a cocher 

On aura souvent besoin d' exploiter une case a cocher de deux facons differentes : 

• en reagissant immediatement a une action sur la case, 

• en cherchant a connaitre son etat a un instant donne. 

1.2.1 Reaction a I'action sur une case a cocher 

Chaque action de l'utilisateur sur une case a cocher genere a la fois : 

• un evenement Action (nous nommons ainsi l'unique evenement appartenant a la categorie 
Action) ; la chaine de commande associee est le libelle correspondant a la case ; 

• un evenement Item (la encore, il s'agit de l'unique evenement de la categorie Item). 

Pour reagir immediatement a un changement d'etat d'une case a cocher, on lui associera done 
un ecouteur approprie, e'est-a-dire de la categorie Action ou de la categorie Item. 

Nous savons deja qu'un ecouteur de la categorie Action doit implementer l'interface Action- 
Listener, e'est-a-dire redefinir la methode actionPerformed. De meme, un ecouteur de la 
categorie Item doit implementer l'interface ItemListener ; comme l'interface ActionListener, 
celle-ci ne comporte qu'une seule methode, itemStateChanged, d'en-tete : 

public void itemStateChanged (ItemEvent ev) 
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Bien entendu, on n'aura generalement aucun interet a traiter le meme evenement a la fois 
dans actionPerformed et dans itemStateChanged. Simplement, on pourra profiter de cette 
redondance pour choisir le type d'ecouteur le plus approprie a son probleme. On notera 
cependant que seuls les evenements Action disposent de la methode getActionCommand. 

1.2.2 Etat d'une case a cocher 

On peut connaitre Fetat d'une case a un moment donne (independamment de son eventuel 
changement d'etat). II suffit pour cela de faire appel a la methode isSelected de la classe 
JCheckBox : 

if ( case. isSelected () ) 

Enfin, independamment de Taction de l'utilisateur, on peut, a tout instant, imposer a une case 
un etat donne en recourant a la methode setSelected 1 : 

case. setSelected( true) ; // coche la case de reference case, quel que 

// soit son etat actuel 
Notez qu'un tel appel genere un evenement Item (mais pas d'evenement Action). 

En general, pour attribuer un etat initial a une case, on utilisera la version appropriee du cons- 
tructeur de JCheckBox, plutot que la methode setSelected. En effet, lors de son appel, Java 
genere des evenements comparables a Taction sur la case (Action et Item). 

1.3 Exemple 

Voici un exemple simple de programme qui introduit dans une fenetre deux cases a cocher et 
un bouton portant T etiquette Etat. Dans la fenetre console, nous "tracons" les changements 
d'etat de chacune des deux cases. Par ailleurs, une action sur le bouton Etat provoque l'affi- 
chage de Tetat des deux cases. 

Ici, nous avons choisi de traiter les evenements Action. Par souci de simplicity, nous utilisons 
le meme objet ecouteur pour le bouton et pour les cases. 

import java.awt.* ; import java.awt. event.* ; import javax.swinq.* ; 
class FenCoches extends JFrame implements ActionListener 
{ public FenCoches () 

{ setTitle ("Exemple de cases a cocher") ; 
setSize (400, 100) ; 

Container contenu = qetContentPane ( ) ; 
contenu . setLayout (new FlowLayout () ) ; 

cochel = new JCheckBox ("case 1") ; 

contenu. add ( coche 1) ; 

cochel . addActionListener (this) ; 



1. Ne confondez pas la methode setEnabled qui permet d'activer ou de desactiver un composant (quel qu'il 
soit), avec la methode setSelected qui permet de dormer un etat donne a certains composants comme les cases 
a cocher ou les boutons radio. 



Les controles usuels 

Chapitre 13 



coche2 = new JCheckBox ("case 2") ; 

contenu . add ( coche2 ) ; 

coche2 . addActionListener (this) ; 

Etat = new JButton ("Etat") ; 

contenu . add (Etat ) ; 

Etat. addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent ev) 
{ Object source = ev.getSource () ; 

if (source == cochel) System. out. println ("action case 1") ; 
if (source == coche2) System. out. println ("action case 2") ; 
if (source == Etat) 

System. out. println ("Etat CASES : " + cochel . isSelected () + " " 

+ coche2 . isSelected ( ) ) ; 

} 

private JCheckBox cochel, coche2 ; 
private JButton Etat ; 

} 

public class Casesl 

{ public static void main (String args[ ] ) 
{ FenCoches fen = new FenCochesO ; 
fen . setvisible (true) ; 

} 
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Remarque 

Si nous avions souhaite gerer les cases a cocher en traitant les evenements Item, il nous 
aurait suffit d'associer aux cases un ecouteur d'evenement Item (ici, toujours la fenetre), 
en modifiant ainsi la classe FenCoches : 

class FenCoches extends JFrame 

implements ActionListener, ItemListener 
{ public FenCoches () 

{ // inchange 

cochel.addltemListener (this) ; 

// inchange 

coche2.addItemListener (this) ; 
// inchange 

} 

public void itemStateChanged (ItemEvent ev) // ecouteur c? evenements Item 
{ Ob j ect source = ev . getSour ce ( ) ; 

if (source == cochel) System. out. println ("action case 1") ; 

if (source == coche2) System. out. println ("action case 2") ; 

} 

public void actionPerformed (ActionEvent ev) // nouvel ecouteur Action 

{ System. out. println ("Etat CASES : " + cochel. isSelected() + " " 

+ coche2.isSelected() ) ; 

} 

Le programme complet figure sur le site Web d' accompagnement, sous le nom 
Cases2.java. 

2 Les boutons radio 

2.1 Generates 

Comme la case a cocher, le bouton radio permet d'exprimer un choix de type oui/non. Mais 
sa vocation est de faire partie d'un groupe de boutons dans lequel une seule option peut etre 
selectionnee a la fois. Autrement dit, le choix d'une option du groupe entraine automatique- 
ment la deactivation de l'option choisie precedemment. En Java, c'est la classe JRadioBut- 
ton qui vous permet d'instancier un tel objet. Comme celui d'une case a cocher, son 
constructeur requiert obligatoirement un libelle qui sera toujours afriche a cote de la case 
pour en preciser le role : 

JRadioButton bRouge = new JRadioButton ("Rouge") ; 
JRadioButton bVert = new JRadioButton ("Vert") ; 

Cependant, si Ton se contente d'ajouter (par add) de tels objets a un conteneur, on obtient 
des composants qui, exception faite de leur aspect, se comporteront exactement comme des 
cases a cocher. Pour obtenir la deactivation automatique d'autres boutons radio d'un meme 
groupe, il faut de plus : 



I Les controles usuels 

B i i i 

• creer un objet de type ButtonGroup, par exemple : 

ButtonGroup groupe = new ButtonGroup ( ) ; 

• associer chacun des boutons voulus a ce groupe a l'aide de la methode add : 

groupe . add (bRouge ) ; 
groupe . add (bVert ) ; 

Notez que F objet de type ButtonGroup sert uniquement a assurer la deactivation automati- 
que d'un bouton lorsqu'un autre bouton du groupe est active. Cet objet n'est pas un compo- 
sant. En particulier, on ne peut pas ajouter un groupe a une fenetre ou a tout autre conteneur ; 
il faut toujours ajouter individuellement chacun des boutons du groupe au conteneur. 

Par defaut, un bouton radio est construit dans l'etat non selectionne (comme une case a 
cocher). On peut lui imposer l'etat selectionne en utilisant une autre version de constructeur, 
comme dans : 

JRadioButton bRouge = new JRadioButton ("Rouge", true) ; 

2.2 Exploitation de boutons radio 

Comme pour une case a cocher, on aura souvent besoin d' exploiter un bouton radio de deux 
facons differentes : 

• en reagissant immediatement a une action sur le bouton, 

• en cherchant a connaitre son etat a un instant donne. 

2.2.1 Reaction a I'action sur un bouton radio 

Comme les cases a cocher, les boutons radio generent des evenements Action et Item. Cepen- 
dant, cette fois, les deux ne sont pas toujours associes. Plus precisement, une action sur un 
bouton radio r provoque : 

• un evenement de type Action et un evenement de type Item pour le bouton r, que celui-ci 
soit selectionne ou non, 

• un evenement de type Item pour le bouton prealablement selectionne dans le meme groupe 
que r, lorsque ce bouton n'est pas r lui-meme. 

Autrement dit, si Ton selectionne un nouveau bouton radio d'un groupe, on obtient bien un 
evenement Act ion pour ce bouton, ainsi qu'un evenement Item pour chacun des deux boutons 
dont l'etat a change. Dans ces conditions, on voit que F evenement Item prend tout son inte- 
ret puisqu'il permet de center les changements d'etats. Mais lorsqu'on agit sur un bouton 
radio deja selectionne, on obtient aussi un evenement Action (ce qui n'est pas trop choquant), 
mais aussi malheureusement un evenement de type Item 1 . 



1. Dans ces conditions, on prendra garde a ne pas suivre l'etat d'un bouton en se contentant de faire "basculer" 
une variable booleenne a chaque evenement Item associe au bouton... 
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2.2.2 Etat d'un bouton radio 

L'etat d'un bouton radio a un instant donne s'obtient exactement comme celui d'une case a 
cocher, par la methode isSelected 1 : 

if (bRouge. isSelected () ) 

De meme, on peut imposer a un bouton un etat donne en recourant a la methode setSelected : 

bRouge. setSelected (true) ; // active le bouton radio de reference bRouge 
La encore, pour attribuer un etat initial a un bouton radio, il est preferable d'utiliser le cons- 
tructeur plutot que setSelected. Dans le second cas, Java genererait un evenement comparable 
au changement d'etat du bouton {Action et Item). 

2.3 Exemples 

Voici deux exemples simples de programmes qui creent tous deux un groupe de trois boutons 
radios, le premier etant initialement selectionne. Un bouton portant l'etiquette Etat permet 
d'afficher l'etat de chacun des trois boutons. Le premier programme se contente de "tracer" 
les evenements Action, tandis que le second "trace" en plus les evenements Item. Dans les 
deux cas, l'exemple d'execution correspond aux memes actions, a savoir un clic sur : bouton 
2, etat, bouton 3, etat, bouton 3 (a nouveau), etat. 

import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

class FenCoches extends JFrame implements ActionListener 
{ public FenCoches () 

{ setTitle ("Exemple de boutons radio") ; 
setSize (400, 100) ; 

Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayout () ) ; 
ButtonGroup groupe = new ButtonGroup ( ) ; 

radiol = new JRadioButton ("Radio 1", true) ; 

groupe. add (radiol) ; 

contenu. add(radiol) ; 

radiol . addActionListener (this) ; 

radio2 = new JRadioButton ("Radio 2") ; 

groupe . add ( radio2 ) ; 

contenu. add (radio2) ; 

radio2 . addActionListener (this) ; 



1 . En fait, cette methode est heritee AbstractButton, classe ascendante commune a JCheckBox et JRadioButton. 
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radio3 = new JRadioButton ("Radio 3") ; 
gr oupe . add ( radio 3 ) ; 
contenu.add(radio3) ; 
radio3 . addActionListener (this) ; 

Etat = new JButton ("Etat") ; 

contenu . add (Etat ) ; 

Etat. addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent ev) 
{ Object source = ev.getSource () ; 

if (source == radiol) System. out. println ("action radio 1") ; 
if (source == radio2) System. out. println ("action radio 2") ; 
if (source == radio3) System. out. println ("action radio 3") ; 
if (source == Etat) 

System. out. println ("Etat RADIOS : " + radiol . isSelected () + " " 

+ radio2. isSelected () + " " + radio3. isSelected () ) ; 

} 

private JRadioButton radiol, radio2 ,radio3 ; 
private JButton Etat ; 

} 

public class Radiosl 

( public static void main (String args[ ] ) 
{ FenCoches fen = new FenCochesO ; 
fen . setvisible (true) ; 

} 

} 

Etat RADIOS : true false false 
action radio 2 

Etat RADIOS : false true false 
action radio 3 

Etat RADIOS : false false true 
action radio 3 

Etat RADIOS : false false true 





Exemple de boutons radio 
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Exemple de gestion des seids evenements Action de boutons radio 
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import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

class FenCoches extends JFrame implements ActionListener, ItemListener 
{ FenCoches ( ) 

{ setTitle ("Exemple de boutons radio") ; 
setSize (400, 100) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayout () ) ; 

ButtonGroup groupe = new ButtonGroup ( ) ; 

radiol = new JRadioButton ("Radio 1") ; 

groupe. add (radiol) ; 

contenu. add(radiol) ; 

radiol. addltemListener (this) ; 

radiol . addActionListener (this) ; 

radiol . setSelected (true) ; 

radio2 = new JRadioButton ("Radio 2") ; 

groupe. add (radio2) ; 

contenu. add (radio2) ; 

radio2 .addltemListener (this) ; 

radio2 . addActionListener (this) ; 

radio3 = new JRadioButton ("Radio 3") ; 

groupe. add (radio3) ; 

contenu. add (radio3) ; 

radio3. addltemListener (this) ; 

radio3 . addActionListener (this) ; 

Etat = new JButton ("Etat") ; 

contenu . add ( Etat ) ; 

Etat. addActionListener (this) ; 

} 

public void itemStateChanged(ItemEvent ev) 
{ Ob j ect source = ev . getSource ( ) ; 

if (source == radiol) System. out. println ("changement radio 1") ; 

if (source == radio2) System. out. println ("changement radio 2") ; 

if (source == radio3) System. out. println ("changement radio 3") ; 

} 

public void actionPerformed (ActionEvent ev) 
{ Ob j ect source = ev . getSource ( ) ; 
if (source == Etat) 

System. out. println ("Etat RADIOS : " + radiol. isSelected() + " " 

+ radio2.isSelected() + " " + radio3.isSelected() ) ; 
if (source == radiol) System. out. println ("action radio 1") ; 
if (source == radio2) System. out. println ("action radio 2") ; 
if (source == radio3) System. out. println ("action radio 3") ; 

} 

private JRadioButton radiol, radio2 ,radio3 ; 
private JButton Etat ; 

) 
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public class Radios2 

{ public static void main (String args[ ] ) 
{ FenCoches fen = new FenCochesO ; 
fen . setvisible (true) ; 

} 

} 

Etat RADIOS : true false false 
changement radio 1 
changement radio 2 
action radio 2 

Etat RADIOS : false true false 
changement radio 2 
changement radio 3 
action radio 3 

Etat RADIOS : false false true 
changement radio 3 
action radio 3 

Etat RADIOS : false false true 





Exemple de boutons radio 
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Exemple de gestion des evenements Action et Item de boutons radio 




Informations complementaires 



Rien dans 1' aspect des boutons radio ne montre qu'ils font partie d'un groupe. Dans cer- 
tains cas, il faudra mettre en evidence les groupes. On pourra utiliser un panneau different 
pour chaque groupe. Les differents panneaux pourront se distinguer les uns des autres par 
leur couleur ou, mieux, etre entoures d'une bordure comportant un titre indiquant le role 
du groupe. Si pan est la reference d'un panneau, voici comment lui affecter une bordure 
avec le titre "Choisissez une option" (il faut importer le paquetage javax.swing. border) : 

pan . setBorder (new TitleBorder ("Choisissez une option")) ; 



3 - Les etiquettes 



371 



3 Les etiquettes 



3.1 



Generalites 



Un composant de type JLabel permet d'afficher dans un conteneur un texte (d'une seule 
ligne) non modifiable par l'utilisateur, mais que le programme peut faire evoluer. 

Le constructeur de JLabel precise le texte initial : 

JLabel texte = new JLabel ("texte initial") ; 
Generalement, un tel composant servira : 

• soit a afficher une information, 

• soit a identifier un composant qui ne Test pas deja (les boutons, les cases a cocher ou les 
boutons radio sont identifies par le texte qu'on leur associe mais il n'en ira pas de me me 
pour les champs de texte ou les listes). Dans ce cas, il faudra probablement agir au niveau 
du gestionnaire de mise en forme pour obtenir F association visuelle convenable, eventuel- 
lement gerer sa taille... 

Contrairement a la plupart des autres composants, une etiquette n'a ni bordure, ni couleur de 
fond : la methode setBackground peut toujours lui etre appliquee, mais elle est sans effet (en 
revanche, on peut toujours agir sur la couleur du texte affiche par setForeground). 

Le programme peut modifier a tout instant le texte d'une etiquette a Faide de la methode set- 
Text, par exemple : 

texte . setText ("nouveau texte") ; 
Notez que la prise en compte du nouveau libelle ne necessite aucun appel supplementaire (tel 
que repaint, validate ou invalidate). 



Voici un programme dans lequel nous utilisons un composant de type JLabel pour afficher en 
permanence le nombre de clics effectues par l'utilisateur sur un bouton donne 
{COMPTEUR) : 

import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

class FenLabel extends JFrame implements ActionListener 
{ public FenLabel () 

{ setTitle ("Essais Etiquettes") ; 
setSize (300, 120) ; 

Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayoutO ) ; 
bouton = new JButton ("COMPTEUR") ; 
bouton . addActionListener (this) ; 
contenu. add (bouton) ; 



3.2 



Exemple 
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nbClics = 0 ; 

compte = new JLabel ("nombre de dies sur COMPTEUR = "+ nbClics) ; 
contenu . add ( compte ) ; 

} 

public void actionPerformed (ActionEvent e) 
{ nbClics+t ; 

compte. setText ("nombre de dies sur COMPTEUR = "+nbClics) ; 

} 

private JButton bouton ; 
private JLabel compte ; 
private int nbClics ; 

} 

public class Labell 

{ public static void main (String args[ ] ) 
{ FenLabel fen = new FenLabel ( ) ; 
fen . setvisible (true) ; 

} 



IH^Essais Etiquettes 




nombre d 


COMPTEUR 

e dies sur COMP 


fEUR = 22 



Comptage du nombre de dies sur un bouton 

\^^~ Remarque 

Pour afficher le nombre de clics, nous aurions pu utiliser deux objets de type JLabel, au 
lieu d'un seul. Le premier aurait comporte un texte fixe et aurait pu etre cree ainsi : 

titre = new JLabel ("nombre de clics sur COMPTEUR = ") ; 

Le second aurait simplement servi a afficher le nombre de clics et il aurait ete modifie a 
chaque action sur le bouton par une instruction de la forme (on suppose qu'il se nomme 
compte) : 

compte . setText ( " "tnbClics ) ; 

Le programme complet ainsi modifie figure sur le site Web d' accompagnement sous le 
nom Label2.java. 
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4 Les champs de texte 

4.1 Generates 

Un champ de texte (on dit aussi une boite de saisie) est une zone rectangulaire (avec bordure) 
dans laquelle l'utilisateur peut entrer ou modifier un texte (d'une seule ligne). II s'obtient en 
instanciant un objet de type JTextField. Son constructeur doit obligatoirement indiquer une 
taille. Celle-ci est exprimee en "nombre de caracteres standard" et non en pixels. La taille 
d'un caractere standard depend de la police employee pour afficher du texte sur un compo- 
sant 1 . Dans le cas de polices a espacement proportionnel (ce qui est le cas de la plupart, dont 
la police par defaut), chaque caractere n'occupe pas exactement la meme largeur ; autrement 
dit, un champ de texte de taille n pourra contenir en moyenne un texte de n caracteres, parfois 
plus, parfois moins, suivant le texte concerne. En pratique, ce point sera rarement important 
car la taille choisie n'infiue nullement sur le nombre de caracteres que l'utilisateur pourra 
saisir ; un mecanisme de defilement sera gere automatiquement par Java en cas de besoin. En 
outre, vous pourrez toujours prevoir une taille sensiblement superieure au nombre maximal 
de caracteres attendus. 

Voici quelques exemples de constructions de champs de texte dans un objet de type JFrame : 

JTextField entreel, entree2 ; 

entreel = new JTextField (20) ; // champ de taille 20, initialement vide 
entree2 = new JTextField ("texte initial", 15) ; // champ de taille 15 

// contenant au depart le texte "texte initial" 

Notez que, contrairement a ce qui se produisait pour les boutons, aucun texte n'est associe a 
un tel composant pour Fidentifier. Generalement, on aura recours a un objet de type JLabel 
qu'on prendra soin de disposer convenablement. 

4.2 Exploitation usuelle d'un champ de texte 

On peut connaitre a tout moment l'information figurant dans un champ de texte en utilisant la 
methode getText, par exemple : 

String ch = entreel .getText () ; //on obtient dans la chaine ch le 

// contenu actuel du champ de texte entreel 
Dans certains cas, le moment de ce prelevement sera impose par une action independante du 
champ de texte lui-meme, par exemple la fermeture d'une boite de dialogue contenant ce 
champ. On peut aussi associer au champ de texte un bouton destine a en valider le contenu ; 
le prelevement se fera alors simplement lors de Faction sur ce bouton. 

Mais on devra souvent exploiter les evenements generes par le champ de texte lui-meme, a 
s avoir : 



1. Pour l'instant, nous continuerons (comme nous l'avons fait pour les autres composants) a nous limiter a la 
police par defaut. Nous verrons plus tard qu'il est possible d'imposer la police de son choix. 
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• un evenement Action provoque par Fappui de Futilisateur sur la touche de validation (le 
champ de texte etant selectionne); 

• un evenement perte de focus, appartenant a la categorie Focus, au moment oil le champ de 
texte perd le focus, c'est-a-dire lorsque Futilisateur selectionne un autre composant (que ce 
soit par la souris ou par le clavier). Comme on peut s'y attendre, les evenements de la cate- 
gorie Focus doivent etre traites par un ecouteur appartenant a une classe qui implemente 
Finterface FocusListener, laquelle comporte deux methodes d'en-tetes 1 : 

public void focusGained (FocusEvent e) // le composant prend le focus 
public void focusLost (FocusEvent e) // le composant perd le focus 

En general, on traitera a la fois la validation et la perte de focus car il n'est guere raisonnable 
de laisser Futilisateur passer a un autre composant alors que le champ de texte contient une 
valeur qui n'est pas encore prise en compte ; en effet, il n'est pas certain qu'il revienne plus 
tard sur le champ texte pour le valider 2 . 

Enfin, bien que la vocation d'un champ de texte soit la saisie d'une information, il est possi- 
ble de le rendre non modifiable (eventuellement temporairement) en utilisant la methode 
setEditable : 

entreel . setEdi table (false) ; // le champ texte entreel n'est plus modifiable 

entreel . setEditable (true) ; // entreel est a nouveau modifiable 
Cette possibilite est parfois utilisee pour profiter de la difference d' aspect visuel d'un champ 
de texte par rapport a une etiquette (le champ de texte possede une couleur de fond et une 
taille). 

Bien entendu, par defaut, un champ de texte est modifiable. 

Informations complementaires 

Lors de F execution on peut modifier la taille d'un champ de texte avec la methode setCo- 
lumns Pour que la modification soit immediatement prise en compte par le gestionnaire 
de mise en forme, il est necessaire de lui appliquer la methode revalidate (ou encore 
d'appliquer la methode validate a son conteneur) : 

entreel . setComumns (30) ; // on donne a entreel une largeur de 30 
entree 1. reval idate () ; // ou encore, si le conteneur est de type JFrame : 

// getContententPane () .validate () ; 



1 . II existe une classe adaptateur FocusAdapter ; on y recourt rarement car la categorie Focus ne comporte que 
deux methodes. 

2. Nous verrons au chapitre 16 qu'on peut savoir si la perte de focus est ou non temporaire en utilisant la me- 
thode isTemporary. 
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Exemple 1 

Voici un programme qui propose a l'utilisateur un champ de texte et un bouton marque 
COPIER. Chaque action sur le bouton provoque la copie dans un second champ de texte (non 
editable et a fond gris) du contenu du premier 1 . 

import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

class FenText extends JFrame implements ActionListener 
{ public FenText () 

{ setTitle ("Saisie de texte") ; 
setSize (300, 120) ; 

Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayoutO ) ; 

saisie = new JTextField (20) ; 

contenu. add (saisie) ; 

saisie . addActionListener (this) ; 

bouton = new JButton ("COPIER") ; 

contenu. add (bouton) ; 

bouton. addActionListener (this) ; 

copie = new JTextField (20) ; 
copie . setEditable (false) ; 
contenu . add ( copie ) ; 

} 

public void actionPer formed (ActionEvent e) 
{ if (e.getSource () == bouton) 

{ String texte = saisie. getText () ; 
copie . setText ( texte ) ; 

} 

} 

private JTextField saisie, copie ; 
private JButton bouton ; 

} 

public class Textl 

{ public static void main (String args[ ] ) 
{ FenText fen = new FenText () ; 
fen . setvisible (true) ; 

} 



1. Nous aurions pu nous contenter d'utiliser une etiquette (JLabel), mais nous n'aurions pas pu lui imposer de 
couleur (ici grise) comme nous l'avons fait pour le champ de texte non editable. 
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|Bonjour cher ami 




COPIER 




Bonjour cher ami 



Exemple d 'exploitation d'un champ de texte par action sur un bouton 

Remarques 

1 Dans la methode actionPerformed, nous devons identifier la source de l'evenement afin 
de distinguer une action sur le champ de texte d'une action sur le bouton COPIER. Notez 
cependant que, si nous ne l'avions pas fait, il y aurait simplement copie lors d'une valida- 
tion du champ de texte. 

2 Le champ utilise pour presenter la copie a ete rendu non editable. Lorsque le texte est 
trop grand, il est certes toujours copie mais on n'en voit que la fin ; il n'est pas possible 
d'y placer le curseur pour le faire defiler... 

Exemple 2 

Voici maintenant un programme voisin du premier dans lequel on retrouve toujours un 
champ de texte. Mais cette fois, sa copie dans un champ de texte non editable est declenchee 
soit par la validation du champ, soit par la perte de focus. A simple titre indicatif, nous avons 
"trace" les differentes actions par des affichages en fenetre console (y compris pour la perte 
de focus bien qu'ici elle n'ait pas d'interet). Notez que bien que la fenetre ne comporte qu'un 
composant, on peut faire perdre le focus au champ texte en selectionnant une autre fenetre (le 
champ de texte non editable ne peut pas recevoir le focus) 1 . 

import java.awt.* ; import java.awt. event.* ; import javax. swing.* ; 
class FenText extends JFrame implements ActionListener, FocusListener 
{ public FenText () 

{ setTitle ("Saisie de texte") ; 
setSize (300, 100) ; 

Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayout ( ) ) ; 



1 . L'experimentation de ce petit programme vous permettra de vous familiariser avec la notion de focus. 
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saisie = new JTextField (20) ; 
contenu.add(saisie) ; 
saisie . addActionListener (this) ; 
saisie. addFocusListener (this) ; 
copie = new JTextField (20) ; 
copie . setEditable (false) ; 
contenu . add (copie ) ; 

} 

public void actionPer formed (ActionEvent e) 
{ System. out. println ("validation saisie") ; 

String texte = saisie. getText () ; 

copie . setText ( texte ) ; 

} 

public void focusLost (FocusEvent e) 

{ System. out. println ("perte focus saisie") ; 

String texte = saisie. getText () ; 

copie . setText (texte ) ; 

} 

public void focusGained (FocusEvent e) 

{ System. out. println ("focus sur saisie") ; 

} 

private JTextField saisie, copie ; 
private JButton bouton ; 

} 

public class Text2 

{ public static void main (String args[ ] ) 
{ FenText fen = new FenTextO ; 
fen . setvisible (true) ; 

} 



focus sur saisie 
validation saisie 
perte focus saisie 
focus sur saisie 
perte focus saisie 
focus sur saisie 
perte focus saisie 
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Exemple d' exploitation d'un champ de texte par validation ou perte de focus 
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4.3 Exploitation fine d'un champ de texte 

Dans les exemples precedents, nous nous sommes contentes de lire le contenu du champ de 
texte a des moments particuliers (action sur un bouton, validation du champ, perte de focus). 

Dans certains cas, vous souhaiterez etre informe de tous les changements que l'utilisateur 
effectue sur le champ de texte. Vous pourriez penser qu'il suffit pour cela d'intercepter tous 
les evenements clavier en provenance du champ de texte (vous apprendrez plus tard com- 
ment). Mais cela ne serait pas suffisant car l'utilisateur peut modifier le contenu d'un champ 
de texte sans necessairement utiliser le clavier ; il suffit qu'il precede a des copier/coller. 

En realite, comme tous les composants Swing, le composant JTextField est implemente en 
utilisant ce que Ton nomme une architecture modele-vue-controleur (ou, bien que ce soit 
plus restrictif, vue-document). Cela signifie qu'un objet de type Document est utilise pour 
conserver le veritable contenu du composant, tandis qu'un autre objet nomme "vue" est uti- 
lise pour fournir une certaine representation de ce contenu 1 . 

Toute modification de l'objet de type Document associe au champ de texte genere un des 
trois evenements de la categorie Document. Ceux-ci doivent etre traites par un ecouteur 
appartenant a une classe qui implemente F interface DocumentListener, laquelle comporte 
trois methodes d'en-tetes 2 : 

public void insertUpdate (DocumentEvent e) // des caracteres ont ete inseres 
public void removeOpdate (DocumentEvent e) // des caracteres ont ete supprimes 
public void changedUpdate (DocumentEvent e) // pas genere par un champ de texte 

Le dernier evenement {changedUpdate) n'est jamais genere par un champ de texte. L'objet 
document associe a un composant s'obtient par la methode getDocument. 

Exemple 

Voici un programme qui affiche en permanence dans un champ de texte non editable le con- 
tenu d'un autre champ de texte, quelles que soient les actions de l'utilisateur : 



import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

import javax. swing. event.* ; // utile pour DocumentListener .... 
class FenText extends JFrame implements DocumentListener 
{ public FenText () 

{ setTitle ("Miroir d' un texte") ; setSize (300, 110) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayoutO ) ; 



1 . Un objet dit controleur gere les actions de l'utilisateur et les repercute sur la vue et sur le contenu. Dans le cas d'un 
composant aussi simple que le champ de texte, la dissociation vue-document semble de peu d'interet. En revanche, 
si Ton considere un traitement de texte, le document est le itchier concerne ; plusieurs vues du meme document peu- 
vent apparaitre dans differentes fenetres. 

2. II n'existe pas de classe adaptateur. 
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saisie = new JTextField (20) ; 
contenu.add(saisie) ; 

saisie. getDocument () .addDocumentListener (this) ; 

copie = new JTextField (20) ; 

copie . setEditable (true) ; 

copie . setBackground (Color. gray) ; 

contenu . add ( copie ) ; 

} 

public void insertUpdate (DocumentEvent e) 
{ String texte = saisie. getText () ; 
copie . setText ( texte ) ; 

} 

public void removeUpdate (DocumentEvent e) 
{ String texte = saisie. getText () ; 
copie . setText (texte ) ; 

} 

public void changedUpdate (DocumentEvent e) 
{} 

private JTextField saisie, copie ; 
private JButton bouton ; 

} 

public class Text3 

{ public static void main (String args! ] ) 
{ FenText fen = new FenTextO ; 
fen . setvisible (true) ; 

} 

} 

] 



Exemple de copie permanente d'un champ de texte 

5 Les boites de liste 

5.1 Generates 

En Java, la boite de liste est un composant qui permet de choisir une ou plusieurs valeurs 
dans une liste predefinie. Nous verrons au paragraphe suivant qu'un composant voisin, la 
boite combo, s'avere generalement plus pratique que la liste des qu'on limite le choix a une 
seule valeur. 

On cree une boite de liste en fournissant un tableau de chaines a son constructeur, par 
exemple : 



^Miroir d'un texte 



Bon i out 
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Stringf ] couleurs ={ "rouge", "bleu", "gris", "vert", "jaune", "noir" } ; 
JList liste = new JList (couleurs) ; 

Apres incorporation dans un conteneur, on obtient un composant se presentant ainsi : 




Initialement, aucune valeur n'est selectionnee dans la liste. Le cas echeant, on peut forcer la 
selection d'un element de rang donne par la methode setSelectedlndex : 

liste . setSelectedlndex (2) ; // selection prealable de 1' element de rang 2 
II existe trois sortes de boites de liste, caracterisees par un parametre de type : 



Valeur du parametre de type 


Type de selection correspondante 


SINGLE_SELECTION 


Selection d'une seule valeur 


SINGLE_INTERVAL_SELECTION 


Selection d'une seule plage de valeurs (contigues) 


MULTIPLE_INTERVAL_SELECTIOI\l 


Selection d'un nombre quelconque de plages de 
valeurs 



Les differents types de boites de liste 



Par defaut, on a affaire a une boite de type MULTIPLE_INTERVAL_SELECTION. Pour 
selectionner une plage de valeurs, l'utilisateur doit cliquer sur la premiere, appuyer sur la tou- 
che MAJ et, tout en la maintenant enfoncee, cliquer sur la derniere valeur de la plage. Pour 
selectionner plusieurs plages, il doit proceder de meme, tout en maintenant en outre la touche 
CNTRL enfoncee. 

Pour modifier le type de boite de liste, on utilise la methode setSelectionMode d'en-tete : 

void setSelectionMode (int modeDeSelection) 
Le parametre modeDeSelection est l'une des valeurs du tableau ci-dessus. Ainsi, pour que la 
liste precedente permette de ne selectionner qu'une valeur, on procedera ainsi : 

liste . setSelectionMode ( S INGLE_SELECT ION ) ; // liste sera a selection simple 

Informations complementaires 

Par defaut, une boite de liste ne possede pas de barre de defilement. On peut lui en ajouter 
une en introduisant la liste dans un panneau de defilement 1 de type JScrollPane : 




1 . Attention a ne pas faire l'inverse, c'est-a-dire a introduire le panneau de defilement dans la liste, meme si cela 
parait plus naturel. 
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JScrollPane defil = new JScrollPane (liste) ; // introduit la liste 

// dans un panneau de defilement 

II faudra alors prendre soin d'ajouter (par add) au conteneur concerne non plus la liste 
elle-meme, mais le panneau de defilement ; par exemple, pour un conteneur de type 
JFrame : 

getContentPane () .add (defil) ; // ajoute le panneau au contenu de la fenetre 

Par defaut, la liste affichera alors huit valeurs (si elle en contient moins, la barre de 
defilement n'apparaitra pas). On peut modifier ce nombre par la methode 
setVisibleRowCount : 

liste. setVisibleRowCount (3) ; // seules 3 valeurs seront visibles a la fois 

A titre indicatif, voici comment se presenterait la liste precedente ainsi adaptee (pan- 
neau de defilement et limitation a trois valeurs) : 







rouge 






bleu 


: 




gris 









5.2 Exploitation d'une boite de liste 

5.2.1 Acces aux informations selectionnees 

Pour une liste a selection simple, la methode getSelectedValue fournit la (seule) chaine selec- 
tionnee. On notera que son resultat est de type Object et non String 1 ; il faudra done proceder 
a une conversion explicite, comme dans : 

String ch = (String) liste. getSelectedValue () ; // cast obligatoire ici 

Pour les autres types de liste, la methode getSelectedValue reste utilisable mais elle fournit la 
premiere des valeurs selectionnees. Pour obtenir toutes les valeurs, on utilisera la methode 
getSelectedValues qui fournit un tableau d'objets. La encore, une conversion en chaine sera 
necessaire pour chacun des objets selectionnes. Par exemple, pour afficher (en fenetre con- 
sole) toutes les chaines selectionnees dans la liste liste, on pourra proceder ainsi : 

Object!] valeurs = liste. getSelectedValues () ; 
for (int i = 0 ; i< valeurs . length ; i++) 

System. out. println ((String) valeurs[ i] ) ; 




Informations complementaires 



On peut connaitre non seulement les valeurs selectionnees, mais aussi leur position dans 
la liste, a l'aide des methodes suivantes : 



1. En effet, Java permet de creer des listes d'objets quelconques, et non seulement de chaines. 
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int getSelectedlndex ( ) 
intt ] getSelectedlndices ( ) 



// position de la premiere valeur selectionnee 
// tableau donnant les positions de 
// toutes les valeurs selectionnees 



5.2.2 Evenements generes par les boTtes de liste 

Contrairement a d'autres composants, la boite de liste ne genere pas d'evenement Action. 

Dans certains cas, on pourra se contenter d'acceder a l'information selectionnee sur une 
action externe a la boite de liste, par exemple : 

• fermeture d'une boite de dialogue contenant la boite, 

• bouton associe a la liste, servant a valider la selection (et eventuellement a preciser une ac- 
tion a realiser sur la selection, par exemple une ouverture de fichier). 

Dans d'autres cas, il faudra intercepter les evenements generes par la liste elle-meme. lis sont 
de la categorie ListSelection, laquelle ne comporte qu'un seul type d'evenement. On le trai- 
tera par un ecouteur approprie, c'est-a-dire d'une classe implementant l'interface ListSelec- 
tionListener (elle figure dans le paquetage swing. event) qui comporte une seule methode 
valueChanged d'en-tete : 

public void valueChanged (ListSelectionEvent e) 

Mais, assez curieusement, ces evenements sont generes plus souvent qu'on ne le souhaiterait 
pour une bonne gestion de la liste. En effet, meme dans le cas d'une liste a selection simple, 
on les obtient : 

• lors de l'appui sur le bouton de la souris car il correspond a la deselection de la valeur pre- 
cedente, 

• lors du relachement du bouton, qui correspond a la selection d'une nouvelle valeur. 

Pour pallier cette redondance, la classe JList dispose d'une methode getValueh Adjusting per- 
mettant de savoir si Ton est ou non en phase de transition. On exploitera done generalement 
la methode valueChanged suivant le schema : 



La classe JList ne prevoit pas de traitement particulier d'un double clic. Pour y parvenir, il 
faut traiter les evenements Mouse correspondants comme nous apprendrons a le faire au 
chapitre 16. 



public void valueChanged (ListSelectionEvent e) 
{ if ( ! e . getValuelsAdj usting ( ) ) 

{ // acces aux informations selectionnees et traitement 




Remarque 
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Dans certains cas, on aimerait pouvoir faire evoluer dynamiquement le contenu d'une 
liste. Aucune methode n'est prevue a cet effet dans la classe JList. En theorie, il est cepen- 
dant possible de modifier le contenu d'une liste ; encore faut-il savoir qu'en Java, ce com- 
posant est implements suivant une architecture de type modele-vue-controleur. La 
demarche consiste alors a gerer soi-meme les donnees associees a la liste en implemen- 
tant les methodes d'une interface nommee ListModel ou en derivant une classe de Abs- 
tractListModel. Nous n'en dirons pas plus ici, sachant que la boite combo vous permettra 
d'obtenir des resultats comparables, de facon beaucoup plus simple. 

5.3 Exemple 

Voici un programme qui creee une liste proposant des noms de couleurs. On y traite les eve- 
nements de la categorie ListSelection en recourant a la methode getValueisAdjusting, comme 
explique ci-dessus. Ici, le traitement de ces evenements se limite a 1'affichage en fenetre con- 
sole des differentes valeurs selectionnees. L' exemple d' execution a ete obtenu ainsi : clic sur 
gauche, appui sur MAJ, clic sur gris, appui sur CTRL, clic sur jaune. 

import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

import javax. swing. event.* ; // utile pour ListSelectionListener 
class FenList extends JFrame implements ListSelectionListener 
{ public FenList () 

{ setTitle ("Essais boite de liste") ; 
setSize (300, 160) ; 

Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayoutO ) ; 
liste = new JList (couleurs) ; 
contenu . add (liste) ; 

liste. addListSelectionListener (this) ; 

} 

public void valueChanged (ListSelectionEvent e) 
{ if ( ! e . getValueisAdjusting ( ) ) 

{ System. out. println ("**Action Liste - valeurs selectionnees :") ; 
Object!] valeurs = liste. getSelectedValues () ; 
for (int i = 0 ; i< valeurs . length ; i++) 
System. out. println ((String) valeurs! i] ) ; 

} 

} 

private String!] couleurs = {"rouge", "bleu", "gris", "vert", 

"jaune", "noir" } ; 

private JList liste ; 

} 
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public class Liste 

{ public static void main (String args[ ] ) 
{ FenList fen = new FenListO ; 
fen . setvisible (true) ; 

} 

} 

** Action 
rouge 
** Action 
rouge 
bleu 
gris 

** Action 
rouge 
bleu 
gris 
jaune 



|£2?Essais boite de liste 


I- 


rouge 






bleu 






gris 






vert 






jaune 






noir 







Liste - valeurs 
Liste - valeurs 

Liste - valeurs 



selectionnees : 
selectionnees : 

selectionnees : 



Exemple d' utilisation d'une boite de liste 



A titre indicatif, voici les affichages que nous aurions obtenus si nous n'avions pas elimine 
les evenement redondants avec getValuelsAdjusting : 

**Action Liste - valeurs selectionnees : 
rouge 

**Action Liste - valeurs selectionnees : 
rouge 

**Action Liste - valeurs selectionnees : 

rouge 

bleu 

gris 

**Action Liste - valeurs selectionnees : 

rouge 

bleu 

gris 

**Action Liste - valeurs selectionnees : 

rouge 

bleu 
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gris 
jaune 

**Action Liste - valeurs selectionnees : 

rouge 

bleu 

gris 

jaune 

Toujours a titre indicatif, voici les affichages que nous aurions obtenus avec le programme 
initial (qui utilise getValuelsAdjusting) en recourant partiellement au clavier 1 pour effectuer 
les memes selections, c'est-a-dire en procedant ainsi : clic sur rouge, appui sur MAJ, deplace- 
ment de la selection par la touche "fleche bas" jusqu'a gris, appui sur CTRL, clic sur jaune : 

**Action Liste - valeurs selectionnees : 
rouge 

**Action Liste - valeurs selectionnees : 

rouge 

bleu 

**Action Liste - valeurs selectionnees : 

rouge 

bleu 

gris 

**Action Liste - valeurs selectionnees : 

rouge 

bleu 

gris 

jaune 



6 Les boites combo 

6.1 Generates 

6.1.1 La botte combo pour I'utilisateur du programme 

La boite de liste combinee (ou liste combinee, ou encore boite combo) associe un champ de 
texte (par defaut non editable) et une boite de liste a selection simple. Tant que le composant 
n'est pas selectionne, seul le champ de texte s'affiche, comme ici : 





fouge 











1. II n'est pas possible d'effectuer la selection de plusieurs intervalles en ne servant que du clavier.. 
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Lorsque l'utilisateur selectionne le champ de texte, la liste s'affiche, par exemple : 

fuuge 
rouge 
bleu 
gris 
vert 
jaune 
noir 



L'utilisateur peut choisir une valeur dans la liste, qui s'affiche alors dans le champ de texte. 
Apres validation (ou perte de focus), la liste s'efface pour ne plus laisser apparaitre que le 
champ de texte (avec la nouvelle selection). 

Par defaut, le champ de texte associe a une boite combo n'est pas editable, ce qui signifie 
qu'il sert seulement a presenter la selection courante de la liste. Mais il peut etre rendu edita- 
ble. L'utilisateur peut alors y entrer, soit une valeur de la liste (en la selectionnant), soit une 
valeur de son choix (en la saisissant classiquement, par le clavier ou par copier/coller). On 
notera bien que, dans ce cas, la nouvelle valeur ainsi entree n'est pas ajoutee automatique- 
ment par Java a la liste. On verra cependant qu'on dispose de methodes permettant de modi- 
fier dynamiquement la liste, done d'effectuer eventuellement de tels ajouts si on le desire. 

6.1.2 Construction d'une boite combo 

On construit une boite combo comme une boite de liste. Par exemple, on pourra construire la 
boite combo presentee ci-dessus de cette facon : 

String! ] couleurs ={ "rouge", "bleu", "gris", "vert", "jaune", "noir" } ; 
JComboBox combo = new JComboBox (couleurs) ; 

Pour rendre une boite combo editable, on utilisera la methode setEditable, par exemple : 

combo. setEditable (true) ; // la boite de texte associee est editable 
Contrairement a une boite de liste, la boite combo sera dotee d'un ascenseur des que son 
nombre de valeurs sera superieur a 8. On peut modifier le nombre de valeurs visibles par la 
methode setMaximumRowCount : 

combo . setMaximumRowCount (4) ; // au maximum 4 valeurs affichees 

Comme pour une boite de liste, on peut forcer la selection d'un element de rang donne par 

setSelectedlndex : 

combo . setSelectedlndex (2) ; // selection prealable de 1' element de rang 2 

6.2 Exploitation d'une boite combo 

Malgre ses similitudes avec une boite de liste, la boite combo s'exploite de facon assez 
differente ; les evenements et les methodes mis en jeu sont generalement differents. 
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6.2.1 Acces a I'information selectionnee ou saisie 

La methode getSelectedltem fournit la valeur selectionnee, qu'il s'agisse d'une valeur prove- 
nant de la liste predefinie ou d'une valeur saisie dans le champ texte associe. Comme la 
methode setSelectedValue des boites de liste, elle fournit un resultat de type Object qu'il fau- 
dra souvent convertir en chaine : 

Object valeur = combo . getSelectedltem ( ) ; 
La methode getSelectedlndex fournit aussi le rang de la valeur selectionnee. Si cette informa- 
tion est generalement peu interessante dans le cas d'un champ de texte non editable, elle le 
devient avec un champ de texte editable. En effet, lorsque l'utilisateur y a entre effectivement 
une information, la methode getSelectedlndex fournit la valeur -1. II est ainsi possible de dis- 
cerner une saisie dans le champ texte d'une selection dans la liste, avec une exception cepen- 
dant lorsque l'utilisateur saisit une valeur figurant deja dans la liste (si on souhaite traiter 
cette situation, il faudra comparer la valeur saisie avec toutes celles de la liste). 

6.2.2 Les evenements generes par une boTte combo 

Comme pour une boite de liste, on pourra parfois se contenter d'acceder a I'information 
selectionnee sur une action externe (bouton associe, fermeture d'une boite de dialogue conte- 
nant la boite combo). 

Mais souvent, on cherchera a intercepter les evenements generes par la boite. Or contraire- 
ment a la boite de liste, la boite combo genere des evenements Action : 

• lors d'une selection d'une valeur dans la liste, 

• lors de la validation du champ texte (lorsqu'il est editable). 

On notera bien qu'aucun evenement Action n'est genere en cas de perte de focus. On retrouve 
la le meme phenomene que pour les champs texte. Bien entendu, ce point n'a aucune impor- 
tance si le champ texte de la boite combo n'est pas editable. Dans le cas contraire, il faudra 
decider si l'on juge ou non raisonnable de permettre a l'utilisateur de quitter une boite combo 
sans valider une information non prise en compte... 

Par ailleurs, la boite combo genere des evenements Item (et non plus ListSelection comme la 
boite de liste) a chaque modification de la selection. Comme la categorie ListSelection, la 
categorie Item ne comporte qu'un seul type evenement. On le traitera par un ecouteur appro- 
prie, c'est-a-dire une classe implementant l'interface ItemListener qui comporte une seule 
methode d'en-tete : 

public void itemStateChanged (ItemEvent e) 
Mais, comme pour une boite de liste a selection simple, on obtient toujours deux evenements 
(suppression d'une selection, nouvelle selection), qu'il s'agisse d'une saisie dans le champ 
texte ou d'une nouvelle selection dans la liste 1 . 



1. II n'existe pas de methode comparable a getValueh Adjusting pour eliminer cette redondance. 
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6.2.3 Exemple 

Voici un programme qui met en evidence les evenements Action et Item generes par une boite 
combo dont le champ de texte est editable 1 . L'exemple d'execution a ete obtenu en 
selectionnant bleu, en saisissant orange puis en selectionnant jaune. 

import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

class FenCombo extends JFrame implements ActionListener, ItemListener 
{ public FenCombo () 

{ setTitle ("Essais boite combinee") ; 
setSize (300, 200) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayoutO ) ; 

combo = new JComboBox (couleurs) ; 

combo . setEditable (true) ; 

contenu . add ( combo ) ; 

combo. addActionListener (this) ; 

combo. addltemListener (this) ; 

} 

public void actionPerformed (ActionEvent e) 
{ System. out. print ("action combo : ") ; 

Object valeur = combo. getSelectedl tern () ; 

System. out .println ((String) valeur) ; 

} 

public void itemStateChanged (ItemEvent e) 
{ System. out. print ("item combo : ") ; 

Object valeur = combo. getSelectedl tern () ; 

System. out .println ((String) valeur) ; 

} 

private String! ] couleurs ={ "rouge", "bleu", "gris", "vert", 

"jaune", "noir" } ; 

private JComboBox combo ; 

} 

public class Combo 

( public static void main (String args[ ] ) 
{ FenCombo fen = new FenCombo ( ) ; 
fen . setvisible (true) ; 

} 

} 

item combo : bleu 
action combo : bleu 
item combo : orange 



1. Nous n'exploitons pas la methode setSelectedlndex ; nous le ferons dans l'exemple suivant. 
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item combo : orange 
action combo : orange 
item combo : jaune 
item combo : jaune 
action combo : jaune 




Exemple de traitement des evenements Action et Item d'une boite combo 

6.3 Evolution dynamique de la liste d'une boite combo 

6.3.1 Les principales possibilites 

II n'est pas aise de faire evoluer le contenu d'une boite de liste (JList). La boite combo dis- 
pose quant a elle de methodes appropriees a sa modification. 

La methode addltem permet d'ajouter une nouvelle valeur a la fin de la liste : 

combo . addl tern ("orange") ; // ajoute orange en fin de la liste combo 
La methode insertltemAt permet d'inserer une nouvelle valeur a un rang donne : 

combo . addltemAt ("rose", 2) ; // ajoute rose en position 2 

La methode removeltem permet de supprimer une valeur existante : 

combo . removeltem ("gris") ; // supprime orange de la liste combo 

6.3.2 Exemple 

Voici un programme proposant la meme liste combo que 1' exemple precedent. Mais, cette 
fois, toute valeur saisie par l'utilisateur est ajoutee a la liste. On utilise la methode getSelecte- 
dlndex presentee precedemment pour distinguer une saisie d'une selection dans la liste. 
Notez que le programme ne verifie pas si une valeur saisie n'appartient pas deja a la liste ; si 
tel est le cas, elle apparaitra alors deux fois. L'exemple d'execution propose a ete obtenu 
ainsi : selection de bleu, saisie de orange, selection de jaune, saisie de rose, selection de 
orange. 
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import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing.* ; 

class FenCombo extends JFrame implements ActionListener 
{ public FenCombo () 

{ setTitle ("Essais boite combinee") ; 
setSize (300, 200) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayoutO ) ; 

combo = new JComboBox (couleurs) ; 

combo . setEditable (true) ; 

combo . setMaximumRowCount (6) ; 

contenu . add ( combo ) ; 

combo . addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent e) 
{ System. out. print ("action combo - ") ; 

Object valeur = combo. getSelectedl tern () ; 

int rang = combo . getSelectedlndex ( ) ; 

if (rang == -1) 

{ System. out. println ("saisie nouvelle valeur : " + valeur) ; 
combo . addl tern (valeur) ; 

} 

else 

System. out .println ("selection valeur existante : " + valeur 
+ " de rang : " + rang) ; 

} 

private String! ] couleurs = ("rouge", "bleu", "gris", "vert", "jaune", "noir" } ; 

private JComboBox combo ; 



public class Combo2 

{ public static void main (String args[ ] ) 
{ FenCombo fen = new FenCombo ( ) ; 
fen . setvisible (true) ; 

} 

} 

action combo - selection valeur existante : bleu de rang : 1 
action combo - saisie nouvelle valeur : orange 
action combo - selection valeur existante : jaune de rang : 4 
action combo - saisie nouvelle valeur : rose 

action combo - selection valeur existante : orange de rang : 6 
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Exemple d' introduction dynamique de nouvelles valeurs dans une boite combo 



7 Exemple d'application 

Nous vous proposons maintenant une application complete qui reprend la plupart des possi- 
bility exposees dans ce chapitre. II s'agit de permettre a l'utilisateur de choisir les formes 
qu'il souhaite dessiner dans une fenetre, leurs dimensions et la couleur de fond. 

Pour ne pas trop charger le code, les formes proposees se limitent a l'ovale et au rectangle ; 
l'utilisateur peut en choisir 0, 1 ou 2, par le biais de cases a cocher. Les dimensions (largeur, 
hauteur) sont saisies dans deux champs de texte et sont communes aux differentes formes ; 
les valeurs obtenues, de type String, devront etre convertie en int a l'aide de la methode 
Integer.parselnt presentee au chapitre 9. Enfin, la couleur de fond sera choisie dans une boite 
combo (limitee ici a 4 couleurs). La encore, les valeurs obtenues sont de type String ; il fau- 
dra leur faire correspondre une valeur de type Color, par exemple Color. red pour "Rouge" 
(ici, on ne peut plus veritablement parler de conversion). Pour ce faire, nous utilisons deux 
tableaux en parallele, l'un contenant les noms des couleurs, 1' autre les couleurs correspon- 
dantes. 

Comme nous vous Favons deja conseille a plusieurs reprises, nous dessinons dans un pan- 
neau (JPanel). Pour faciliter les choses, nous placons les differents controles necessaires 
dans un second panneau. Ici, nous pouvons conserver son gestionnaire par defaut 
(FlowLayoui). 

Les panneaux sont places dans la fenetre (plus precisement dans son "contenu"). Ici, nous 
nous contentons du gestionnaire par defaut de JFrame (BorderLayout), en placant 
s implement : 

• le panneau contenant les dessins au centre (position par defaut de add), 

• le panneau contenant les controles en bas (parametre "South" de add). 

Les cases a cocher sont exploiters en traitant l'evenement Action correspondant. Pour les 
champs de texte, nous traitons, outre l'evenement Action, les evenements Focus (en fait la 
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perte de focus), afin d'eviter qu'une valeur ne puisse apparaitre sans avoir ete prise en 
compte. Nous avons choisi d'exploiter la boite combo en traitant l'evenement Item (ici, la 
gestion de la perte de focus n'a pas d'interet puisque la boite ne permet pas la saisie). 

Notez que la communication entre l'objet fenetre et l'objet panneau de dessin se fait par des 
methodes de modification setHauteur, setLargeur, setOvale et setRectangle . 



import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing. event.* ; 

class MaFenetre extends JFrame implements ActionListener, ItemListener, 

FocusListener 

{ static public final Stringt ] nomCouleurs 

= { "rouge", "vert", "jaune", "bleu"} ; 

static public final Color[ ] couleurs 

= (Color. red, Color. green, Color .yellow, Color. blue} ; 

public MaFenetre () 
{ setTitle ("FIGURES") ; 
setSize (450, 200) ; 

Container contenu = getContentPane ( ) ; 

/*** paneau pour les dessins ***/ 
panDes = new PaneauDessin () ; 
contenu . add (panDes ) ; 

panDes. setBackground (Color. cyan) ; // panneau initialement bleu 

/*** paneau pour les commandes ***/ 
panCom = new JPanel ( ) ; 
contenu. add (panCom, "South") ; 

/* choix couleur */ 
comboCoulFond = new JComboBox (nomCouleurs) ; 
panCom. add (comboCoulFond) ; 
comboCoulFond. addltemListener (this) ; 

/* choix dimensions * / 
JLabel dim = new JLabel ("DIMENSIONS") ; panCom. add (dim) ; 
txtLargeur = new JTextField ("50", 5) ; 
txtLargeur . addActionListener (this) ; 
txtLargeur .addFocusListener (this) ; 
panCom. add (txtLargeur) ; 
txtHauteur = new JTextField ("20", 5) ; 
panCom. add (txtHauteur) ; 
txtHauteur . addActionListener (this) ; 
txtHauteur . addFocusListener (this) ; 

/* choix formes * / 
cOvale = new JCheckBox ("Ovale") ; 
panCom. add (cOvale) ; 
cOvale. addActionListener (this) ; 
cRectangle = new JCheckBox ("Rectangle") ; 
panCom. add (cRectangle) ; 
cRectangle . addActionListener (this) ; 

} 
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public void actionPerformed (ActionEvent ev) 
{ if (ev.getSourceO == txtLargeur) setLargeur ( ) ; 
if (ev.getSourceO == txtHauteur) setHauteur() ; 

if (ev.getSourceO == cOvale) panDes .setOvale (cOvale.isSelectedO ) ; 
if (ev.getSourceO == cRectangle) 

panDes . setRectangle ( cRectangle . isSelected ( ) ) ; 

panDes . repaint ( ) ; 

) 

public void focusLost (FocusEvent e) 
{ if (e.getSource () == txtLargeur) 
{ setLargeur ( ) ; 

System. out. println ("perte focus largeur") ; 

panDes . repaint ( ) ; 

} 

if (e.getSource () == txtHauteur) 
{ setHauteur ( ) ; 
panDes . repaint () ; 

} 

} 

public void focusGained (FocusEvent e) 
{} 

private void setLargeur ( ) 

{ String ch = txtLargeur . getText ( ) ; 

System. out. println ("largeur " + ch) ; 

panDes . setLargeur (Integer .parselnt (ch) ) ; 

) 

private void setHauteur ( ) 

{ String ch = txtHauteur . getText ( ) ; 

System. out. println ("hauteur " + ch) ; 

panDes . setHauteur (Integer. parselnt (ch) ) ; 

) 

public void itemStateChanged(ItemEvent e) 

{ String couleur = (String) comboCoulFond.getSelectedl tern () ; 
panDes . setCouleur (couleur) ; 

} 

private PaneauDessin panDes ; 

private JPanel panCom ; 

private JComboBox comboCoulFond ; 

private JTextField txtLargeur, txtHauteur ; 

private JCheckBox cOvale, cRectangle ; 

} 

class PaneauDessin extends JPanel 
{ public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 

if (ovale) g.dravOval (10, 10, 10 + largeur, 10 + hauteur) ; 

if (rectangle) g.drawRect (10, 10, 10 + largeur, 10 + hauteur) ; 

} 

public void setRectangle (boolean b) { rectangle = b ; ) 
public void setOvale (boolean b) { ovale = b ; } 
public void setLargeur (int 1) { largeur = 1 ; } 
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public void setHauteur (int h) { hauteur = h ; } 
public void setCouleur (String c) 

{ for (int i = 0 ; KMaFenetre . nomCouleurs . length ; i++) 

if (c == MaFenetre . nomCouleurst i] ) setBackground (MaFenetre . couleurs[ i] ) ; 

} 

private boolean rectangle = false, ovale = false ; 
private int largeur=50, hauteur=50 ; 



public class Formes 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 




Choix de formes, de leurs dimensions et de la couleur de fond par des controles 



Remarque 



Bien que nous ayons prevu une valeur initiale pour les champs de texte, rien n'interdit a 
l'utilisateur de l'effacer (ou meme d'entrer une valeur incorrecte) ; dans ce cas, une 
exception est declenchee par le programme. 



14 



Les boTtes de dialogue 



Jusqu'ici, nous avons appris a placer des composants dans une fenetre (ou, ce qui revient au 
meme, dans un panneau place dans une fenetre). En general, ces composants restent affiches 
en permanence. Or, pour certaines applications, on a besoin d'etablir un dialogue temporaire 
avec Futilisateur. On pourrait certes y parvenir en exploitant les possibilites d'ajout et de sup- 
pression dynamiques de composants, ou eventuellement en recourant a setVisible(false). 
Mais la boite de dialogue offre une solution beaucoup plus adaptee. Elle permet en effet de 
regrouper n'importe quels composants dans une sorte de fenetre qu'on fait apparaitre ou dis- 
paraitre globalement. Par ailleurs, Futilisateur est parfaitement habitue a son ergonomie, dans 
la mesure ou elle tres utilisee dans les logiciels du commerce. 

Ici, nous allons apprendre a creer et a exploiter de telles boites de dialogue en y introduisant 
les composants de notre choix. Auparavant, nous vous presenterons quelques boites de dialo- 
gue standard fournies par Java et qui pourront vous simplifier les choses dans certaines situa- 
tions simples : affichage d'un message, demande de confirmation, choix d'une option dans 
une liste ou saisie d'un texte. 

1 Les boites de message 

Java dispose de methodes standard vous permettant de fournir a l'utilisateur un message qui 
reste affiche tant qu'il n'agit pas sur un bouton OK. Plus precisement, la classe JOptionPane 
dispose d'une methode statique showMessageDialog permettant d'afficher et de gerer auto- 
matiquement une telle boite. Cette methode dispose de plusieurs variantes. Nous commence- 
rons par examiner la plus simple et la plus repandue, que nous nommerons la boite de 
message usuelle. 
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1.1 La boite de message usuelle 

Si Ton suppose que fen est un objet de type JFrame (ou derive), l'appel : 

JOptionPane . showMessageDialog (fen, "Hello") ; 
affiche dans la fenetre fen la boite de message suivante : 



Message 



Hello 



OK 



J 



Voici un petit programme complet utilisant cette boite de message. Les afHchages en fenetre 
console montrent que l'execution ne se poursuit qu'apres action sur OK. 



import javax. swing.* ; 

class MaFenetre extends JFrame 

{ MaFenetre ( ) 

{ setTitle ("Essai message") ; 
setSize (400, 150) ; 

} 

} 

public class Messl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen. setvisible (true) ; 
System. out .println ("avant message") ; 
JOptionPane. showMessageDialog (fen, "Hello") ; 
System. out .println ("apres message") ; 

} 

) 



Exemple d' utilisation d'une boite de message usuelle dans une fenetre graphique 

On notera que le premier argument de la methode showMessageDialog represente ce que 
Ton nomme la fenetre parent (ou proprietaire) de la boite de message, c'est-a-dire celle dans 
laquelle elle va s'afficher. II est cependant possible d'afficher une boite de message indepen- 
damment de toute fenetre, en donnant a ce premier parametre la valeur nul : 

JOptionPane . showMessageDialog (null, "Hello"); // boite de message 

/ / independante d' une fenetre 
Cette possibilite peut tres bien etre exploitee dans un programme en mode console, comme 
dans cet exemple : 
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import javax. swing.* ; 
import javax. swing.* ; 
public class Mess2 

{ public static void main (String args! ] ) 
{ System. out. println ("avant message") ; 

JOptionPane. showMessageDialog (null, "Hello") ; 
System. out. println ("apres message") ; 

} 

} 

Exemple d' utilisation d'une boite de message usuelle, sans fenetre graphique 

Dans ce cas, le programme ne cree pas de fenetre graphique, mais il affiche quand meme la 
boite de message. 

1 .2 Autres possibilites 

La boite de message usuelle ne permet de definir que le contenu du message. Son titre (Mes- 
sage) et l'icone qu'elle renferme (lettre i comme "information) sont imposes. II existe une 
autre variante de la methode showMessageDialog qui permet de choisir : 

• le contenu du message, 

• le titre de la boite, 

• le type d'icone, parmi la liste suivante (les parametres sont des constantes entieres de la clas- 
se JOptionPane) : 



Parametre 


Type d'icone 


JOptionPane. ERROR_MESSAGE 


Erreur 


JOptionPane. INFORMATION_MESSAGE 


Information 


JOptionPane.WARNING.MESSAGE 


Avertissement 


JOptionPane. QUESTION_MESSAGE 


Question 


JOptionPane. PLAII\I_MESSAGE 


Aucune icone 



Voyez cet exemple : 

import javax. swing.* ; 

class MaFenetre extends JFrame 

{ MaFenetre ( ) 

{ setTitle ("Essai message") ; 
setSize (400, 170) ; 

} 

) 
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public class Mess3 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

JOptionPane.showMessageDialog(fen, "Mauvais choix", 

"Message cT avertissement", 
JOptionPane . ERFOR_MESSAGE ) ; 

} 

) 



I^Essai messaqe 


_|n|x| 




^Message d'avertissementH 






i i Mauvais choix 






OK 









Exemple de choix des parametres d'une boite de message 

\^^~ Remarque 

II existe une troisieme variante qui, outre les parametres precedents, permet de preciser 
une icone quelconque (objet de classe Icon) qui viendra s'ajouter au contenu de la boite. 
Nous apprendrons a manipuler des icones au chapitre 15. 

2 Les boites de confirmation 

Java permet d'afficher des boites dites "de confirmation" offrant a l'utilisateur un choix de 
type oui/non. II suffit pour cela de recourir a l'une des variantes de la methode (statique) 
showConfirmDialog de la classe JOptionPane. La encore, nous examinerons d'abord la plus 
usuelle. 

2.1 La boite de confirmation usuelle 

Si Ton suppose que fen est une fenetre, l'appel : 

JOptionPane . showConfirmDialog (fen, "voulez-vous continuer") ; 

affiche dans la fenetre fen la boite suivante : 
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I^Select an Option 


f 


voulez-vous c out inner 


Yes No Cancel 







La encore, le premier parametre peut prendre la valeur null, auquel cas la boite est affichee 
independamment d'une quelconque fenetre. 

La boite reste affichee jusqu'a ce que l'utilisateur agisse sur Fun des boutons ou qu'il ferme 
la boite. La valeur de retour de la methode showConfirmDialog precise Taction effectuee par 
l'utilisateur, sous la forme d'un entier ayant comme valeur l'une des constantes suivantes de 
la classe JOptionPane 1 : YES_OPTION (0), NO_OPTION (1), CANCEL_OPTION (2) ou 
CLOSED_OPTION (-1 ). 

Voici un exemple 2 reduit a une seule methode main (done correspondant au mode console) 
qui interroge indefiniment l'utilisateur a l'aide de la boite precedente. Ici, F execution corres- 
pond aux actions suivantes : Yes, No, Cancel, fermeture par la case systeme, fermeture par la 
case X. 

import javax. swing.* ; 
public class Confirml 

{ public static void main (String args! ] ) 
{ while (true) 

{ int rep = JOptionPane. showConfirmDialog (null, "voulez-vous continuer") ; 
System. out. println ("reponse : " + rep) ; 

} 

} 

} 



reponse : 0 
reponse : 1 
reponse : 2 
reponse : -1 
reponse : -1 

Exemple a" utilisation d'une boite de confirmation usuelle 



1. Notez que les constantes CANCELJJPTION et CLOSEDJJPTION sont differentes. En pratique, on n'ex- 
ploite pas cette particularite et Ton considere que, dans les deux cas, on a affaire a un abandon du dialogue. 

2. La reponse de l'utilisateur n'a ici aucune incidence sur le deroulement du programme. En general, il en ira 
differemment. 
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2.2 Autres possibilites 

La boite de confirmation usuelle que nous venons de presenter permet seulement le choix de 
la question posee a l'utilisateur. II existe une autre variante de la methode showConfirmDia- 
log qui permet en outre de choisir le titre de la boite, ainsi que la nature des boutons qui s'y 
trouvent. Ceux-ci sont definis par un parametre entier dont la valeur est choisie parmi les 
constantes suivantes : 



Parametre 


Valeur 


Type de boite de confirmation 


JOptionPane. DEFAULT_0PTI0N 


-1 


boite usuelle 


JOptionPane.YES_NO_OPTION 


0 


boutons YES et NO 


JOp- 


1 


boutons YES, NO et CANCEL 


tionPane.YES_NO_CANCEL_OPTION 


2 


boutons OK et CANCEL 


JOptionPane.OK_CANCEL_OPTION 







Les differents types de boites de confirmation 



Par exemple, avec cet appel : 

JOptionPane . showConfirmDialog (null, "voulez-vous continuer", 

"INCIDENT MAJEUR", JOptionPane. YES_NO_OPTION ) 

vous obtiendrez cette boite : 



INCIDENT MAJEUR 



<2> 



voulez-vous continuer 



_ 



No 



La valeur de retour de la methode showConfirmDialog est l'une des suivantes (notez que 
OK_OPTION et YES_OPTION correspondent a la meme valeur ; en pratique, cela n'est pas 
genant car les boutons YES et OK ne sont jamais presents en meme temps) : 



Constante symbolique 


Valeur 


Signification 


JoptionPane.0K_0PTI0N 


0 


action sur OK 


JoptionPane.YES_OPTION 


0 


action sur YES 


JoptionPane.N0_0PTI0N 


1 


action sur NO 


JoptionPane.CANCEL_OPTION 


2 


action sur CANCEL 


JoptionPane.CL0SED_0PTI0N 


-1 


fermeture de la boite 



La valeur de retour de showConfirmDialog 
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Remarque 

II existe une troisieme variante qui, outre les parametres precedents, permet de preciser le 
type d'icone (parmi les valeurs presentees au paragraphe 1.2). Une quatrieme variante 
permet, en plus, d'ajouter une icone quelconque. 



3 Les boites de saisie 

La boite de saisie permet a Futilisateur de fournir une information sous la forme d'une chame 
de caracteres. La methode showInputDialog de la classe JOptionPane vous permet de gerer 
automatiquement le dialogue avec Futilisateur. La encore, il existe plusieurs variantes et nous 
commencerons par la plus usuelle. 



3.1 La boTte de saisie usuelle 

Si Ton suppose que fen est une fenetre, l'appel : 

JOptionPane . showInputDialog (fen, "donnez un texte") 

affiche dans la fenetre fen la boite suivante : 




La methode showInputDialog fournit en retour : 

• soit un objet de type String contenant le texte fourni par l'utilisateur, 

• soit la valeur null si Futilisateur n'a pas confirme sa saisie par OK, autrement dit s'il a agi 
sur Cancel ou s'il a ferme la boite 1 (et ce, meme s'il a commence a entrer une information 
dans le champ de texte). 

Voici un exemple reduit a une seule methode main (done correspondant au mode console) qui 
demande systematiquement des informations a l'utilisateur a Faide de la boite precedente. 
Ici, F execution correspond aux actions suivantes : entree de bonjour et frappe de OK, entree 
d'un texte et frappe de Cancel, fermeture de la boite, entree de hello et frappe de OK, frappe 
de OK sans entrer de texte. 



1. Notez bien que, cette fois, il n'est pas possible de distinguer entre ces differentes actions. 
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import javax. swing.* ; 
public class Inputl 

{ public static void main (String args[ ] ) 
{ String txt ; 
while (true) 

{ txt = JOptionPane . showInputDialog (null, "donnez un texte") ; 
if (txt == null) System. out. println ("pas de texte saisi") ; 

else System. out. println ("texte saisi :" + txt + ": de longueur " 
+ txt. length () ) ; 

} 

} 

} 

texte saisi :bonjour: de longueur 7 

pas de texte saisi 

pas de texte saisi 

texte saisi : hello: de longueur 5 

texte saisi : : de longueur 0 



Exemple d' utilisation d'une botte de saisie usuelle 

3.2 Autres possibilites 

La boite de saisie usuelle que nous venons de presenter permet seulement le choix de la ques- 
tion posee a Putilisateur. II existe une autre variante de showInputDialog qui permet en outre 
de choisir le titre de la boite, ainsi que le type de l'icone (suivant les valeurs fournies au para- 
graphe 1.2). Par exemple, avec cet appel : 

txt = JOptionPane . showInputDialog (null, "entrez votre nom", 

"CONTROLE a IDENTITE", 
JOptionPane . WARNING_MESSAGE ) ; 

vous obtiendrez la boite suivante : 



k'CONmOl F mPFNTITF □ 




entrez votre nom 



4 Les boites d'options 

Java vous permet d'afficher une boite d'options, c'est-a-dire une boite permettant un choix 
d'une valeur parmi une liste, par F intermediate d'une boite combo. Supposons que Ton dis- 
pose d'un tableau de chaines couleurs, defini ainsi : 
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String! ] couleurs ={ "rouge", "vert", "bleu", "jaune", "orange", "blanc"} ; 

Si fen est une fenetre, l'appel suivant : 

JOptionPane . showInputDialog (fen, "choisissez une couleur", "BOITE U OPTIONS", 
JOptionPane . QUESTION_MESSAGE, /* type d' icone, comme au paragraphe 1.2 */ 
null, /* icone supplementaire (ici aucune) */ 

couleurs, /* tableau de chaines presentees dans la boite combo */ 

couleurst 1] ) ; /* rang de la chaine selectionnee par def aut s * / 

provoquera l'affichage dans fen de la boite suivante : 




L'utilisateur pourra : 

• soit choisir une couleur dans la boite combo et agir sur OK pour valider 1 ; 

• soit quitter par action sur Cancel ou par fermeture de la boite. 

La valeur de retour de la methode showInputDialog, de type Object, correspond a F option 
selectionnee s'il y en a une, sinon a la valeur null. Sa conversion en String sera generalement 
necessaire. 

Voici un exemple de programme utilisant une telle boite. Ici, la boite s'affiche suite a une 
action de l'utilisateur sur un bouton portant l'etiquette CHOIX, situe en bas d'une fenetre. 



import javax. swing.* ; import java.awt.* ; import j ava . awt . event . * ; 
class Fenlnput extends JFrame implements ActionListener 

{ String! ] couleurs ={ "rouge", "vert", "bleu", "jaune", "orange", "blanc"} ; 
public Fenlnput () 
{ setTitle ("Essai options") ; 
setSize (400, 220) ; 

JButton saisie = new JButton ("CHOIX") ; 
getContentPane () .add(saisie, "South") ; 
saisie. addActionListener (this) ; 

} 

public void actionPer formed (ActionEvent e) 

{ System. out. println ("** affichage boite d' options") ; 
String txt = (String) JOptionPane. showInputDialog (this, 

"choisissez une couleur", "BOITE D'OPTIONS", 
JOptionPane . QUE S T ION_ME S SAGE , null, 
couleurs, couleurs[ 1] ) ; 



1. Attention : la frappe de la touche return annule le dialogue (il n'y a pas validation de la selection). 
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if (txt == null) System. out. println (" pas de choix effectue") 
else System. out. println (" option choisie :" + txt) ; 



} 



public class Optionsl 

{ public static void main (String args[ ] ) 
{ Fenlnput fen = new FenlnputO ; 
fen. setvisible (true) ; 



issai options 



- n x 



gjBOITE D-OPTIONS 




pi choisissez une couleur 






vert 








laune 








orange 















CHOIX 



Exemple d' utilisation d'une boite d'options 



Remarque 

II existe egalement une methode nommee showOptionDialog, affichant les options vou- 
lues, non plus sous la forme d'une boite combo, mais a raison d'un bouton pour chacune 
des options. Ainsi, en rempla^ant l'appel de showInputDialog du programme precedent 
par : 

int rang = JOptionPane . showOptionDialog (this, "choisissez une couleur", 
"EOITE U OPTIONS", JOptionPane. YES_NO_CANCEL_OPTION, 
JOptionPane. QUESTION MESSAGE, null, couleurs, couleurs[ 1] ) ; 



vous obtiendriez une boite se presentant ainsi : 



BOITE D'OPTIONS 



choisissez une couleur 





rouge 




vert 




bleu 




jaune 


orange 




blanc 
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Le resultat fourni par showOptionDialog est un entier correspondant au rang de 
1' option choisie (ou a une valeur negative en cas d' absence de choix). Le programme 
complet ainsi modifie figure sur le site Web d'accompagnement sous le nom 
Options2.java. 



5 Les boites de dialogue personnalisees 



Dans les paragraphes precedents, nous vous avons presente des boites de dialogue standard. 
Pour les utiliser, il suffisait de faire appel a une methode statique (telle que JOp- 
tionPane.showInputDialog) qui realisait les operations suivantes : 

• creation de l'objet bolte de dialogue, 

• affichage, 

• gestion du dialogue avec l'utilisateur, 

• fermeture de la boite de dialogue, 

• transfert eventuel d' information (par le biais de la valeur de retour). 

Mais il vous arrivera d' avoir besoin de boites de dialogue plus elaborees. Pour ce faire, Java 
dispose d'une classe JDialog qui vous permettra de creer vos propres boites de dialogue. 
Nous allons voir comment la mettre en cravre et comment prendre nous-memes en charge les 
differentes operations evoquees ci-dessus. 



5.1 Construction et affichage d'une boite de dialogue 

5.1.1 Construction 

La facon la plus usuelle de construire un objet boite de dialogue se presente ainsi (on suppose 
que fen est un objet fenetre) : 



Le premier argument du constructeur designe la fenetre proprietaire (parent) de la boite de 
dialogue. Nous avons rencontre cette notion dans le cas des boites de dialogue standard et 
nous avons pu constater qu'elle avait peu d'importance en pratique. II ne faut pas la confon- 
dre avec la notion d'appartenance d'un composant a un conteneur. 

Le deuxieme argument du contructeur est le titre qu'on souhaite donner a la boite. Enfin, le 
dernier argument precise si la boite est "modale" {true) ou "non modale" (false). Avec une 
boite modale, l'utilisateur ne peut pas agir sur d'autres composants que ceux de la boite tant 
qu'il n'a pas mis fin au dialogue. Les boites de dialogue standard de Java sont modales 
comme la plupart des boites de dialogue des logiciels du commerce. 



JDialog bd = new JDialog (fen, 



"Ma boite de dialogue", 
true) ; 



// fenetre proprietaire 
// titre de la boite 
// boite modale 
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5.1.2 Affichage 



Comme pour une fenetre, il est necessaire d'attribuer une taille a une boite de dialogue par la 
methode setSize (on peut aussi utiliser setBounds) et d'en provoquer 1' affichage par l'appel 
de setVisible : 

bd.setvisible (true) ; // affiche la boite de dialogue bd 
II est tres important de noter que, a partir du moment oil Ton a affaire a une boite modale, on 
n'executera pas Finstruction suivant l'appel de setVisible, tant que l'utilisateur n'aura pas mis 
fin au dialogue 1 . 

5.1.3 Exemple 

Voici un premier exemple de programme qui cree et affiche une boite de dialogue (pour 
1' instant vide) en reponse a une action de l'utilisateur sur un bouton marque Lancement 
dialogue : 



import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class FenDialog extends JFrame implements ActionListener 
{ public FenDialog () 

{ setTitle ("Essai boite de dialogue") ; 
setSize (400, 200) ; 

lanceDial = new JButton ("Lancement dialogue") ; 
Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayout ( ) ) ; 
contenu. add (lanceDial) ; 
lanceDial . addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent e) 

{ JDialog bd = new JDialog(this, "Mon dialogue", true) ; 

System. out .println ("avant affichage boite dialogue") ; 

bd. setSize (250, 100) ; 

bd. setVisible (true) ; 

System. out. println ("apres fermeture boite dialogue") ; 

} 

private JButton lanceDial ; 



public class Dialogl 

{ public static void main (String args[ ] ) 
{ FenDialog fen = new FenDialog () ; 
fen . setVisible (true) ; 

} 



1. Heureusement, il n'en va pas de meme pour une fenetre ! 
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avant affichage 
apres fermeture 
avant affichage 
apres fermeture 
avant affichage 



boite dialogue 
boite dialogue 
boite dialogue 
boite dialogue 
boite dialogue 



^sjFssai boite de dialogue 




Exemple d 'utilisation d'une boite de dialogue (vide) 

Lors de 1' execution du programme, les affichages effectues en fenetre console mettent en evi- 
dence l'aspect modal de la boite. Notez que, pour l'instant, la seule facon de mettre fin au 
dialogue consiste a fermer la boite. Nous verrons bientot une autre facon d'y parvenir. 

5.1.4 Utilisation d'une classe derivee de JDialog 

Le programme precedent utilisait simplement un objet de type JDialog. En pratique, on sera 
souvent amene (comme pour JFrame) a creer une classe derivee de JDialog, qu'on pourra 
specialiser en introduisant les champs et les fonctionnalites dont on aura besoin. 

A titre indicatif, voici comment nous pouvons transformer (artificiellement) dans ce sens 
l'exemple precedent. Ici, la taille de la boite est definie dans son constructeur et non plus 
depuis l'exterieur (le programme complet figure sur le site Web d' accompagnement sous le 
nom Dialogla.java) : 



class FenDialog extends JFrame implements ActionListener 
{ public FenDialog () 

{ // ... constructeur inchange 

} 

public void actionPer formed (ActionEvent e) 
{ MonDialogue bd = new MonDialogue (this) ; 

System. out. println ("avant affichage boite dialogue") ; 

bd.setvisible (true) ; 

System. out. println ("apres fermeture boite dialogue") ; 

} 

private JButton lanceDial ; 
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class MonDialogue extends JDialog 

{ public MonDialogue (JFrame proprio) 

{ super (proprio, "Mon dialogue", true) ; 
setSize (250, 100) ; 

} 

} 

public class Dialogla 

( public static void main (String args[ ] ) 
{ FenDialog fen = new FenDialogO ; 
fen . setvisible (true) ; 

} 

} 

Utilisation d'une classe specialisee derivee de JDialog 



5.2 Exemple simple de boTte de dialogue 

Pour qu'elle presente un interet, une boite de dialogue devra bien entendu comporter des 
composants et, generalement, etre en mesure de transmettre des informations. La plupart du 
temps, elle comportera un bouton OK destine a valider les informations que l'utilisateur aura 
pu y entrer ; parfois, elle comportera aussi un bouton Cancel, permettant a l'utilisateur 
d'abandonner le dialogue sans entrer d' informations (ou, du moins, sans que les informations 
qu'il ait pu entrer soient prises en compte). 

Nous vous proposons pour l'instant de creer une boite de dialogue simple jouant le meme 
role qu'une boite de saisie, c'est-a-dire comportant uniquement un champ de texte et un bou- 
ton OK. Malgre sa simplicity cet exemple nous permettra de vous montrer comment intro- 
duire des composants dans la boite et comment mettre fin au dialogue ; il vous proposera 
egalement une premiere demarche de transmission de 1' information. 

5.2.1 Introduction des composants 

On introduit un composant dans une boite de dialogue exactement comme dans une fenetre. 
Autrement dit, on ajoute un composant par add, non pas a la boite de dialogue elle-meme, 
mais a son contenu qu'on obtient par la methode getContentPane . Par defaut, la boite de dia- 
logue est dotee d'un gestionnaire de mise en forme de type BorderLayout. Dans notre exem- 
ple, nous le remplacerons par un gestionnaire de type FlowLayout. 

Ces differentes operations peuvent tout a fait etre realisees dans le constructeur de la boite de 
dialogue, pour peu qu'on en fasse une classe specialisee, derivee de JDialog. Dans ces condi- 
tions, voici comment nous pourrions proceder pour introduire nos deux composants (bouton 
OK et champ de texte) : 

class MonDialog extends JDialog 

( public MonDialog (JFrame proprio) 

{ super (proprio, "Dialogue de saisie", true) ; 
setSize (250, 120) ; 
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okBouton = new JButton ("OK") ; 
champTexte = new JTextField (20) ; 
Container contenu = getContentPane ( ) ; 
contenu . setLayout (new FlowLayout () ) ; 
contenu. add (okBouton) ; 
contenu . add ( champTexte ) ; 



5.2.2 Gestion du dialogue 

En general, on n'aura pas a se preoccuper de gerer les differents controles contenus dans la 
boite de dialogue, exception faite du bouton OK qui devra mettre fin au dialogue. Pour ce 
faire, l'objet ecouteur qui lui sera associe devra effectuer l'appel : 



Notez bien la double fonction de cet appel : il rend invisible la boite de dialogue mais, de 
plus, il met fin au dialogue, permettant ainsi a l'execution de se poursuivre apres l'instruction 
d'affichage de la boite. 

Sachez egalement qu'un tel appel est realise automatiquement par la classe JDialog en cas de 
fermeture de la boite par l'utilisateur. II n'a done pas a etre prevu explicitement. 

En general, Taction sur OK sert a valider les informations fournies par l'utilisateur alors 
qu'une fermeture de la boite (ou, eventuellement, une action sur un bouton Cancel) annule le 
dialogue. On sera done souvent amene a utiliser, dans l'objet de type MonDialog, une varia- 
ble booleenne (nommee par exemple ok) qu'on initialisera a false a l'affichage de la boite et 
qu'on placera a true en cas d'action sur OK (cette variable restera bien a false si l'utilisateur 
ferme la boite). Dans ces conditions, la methode actionPerformed de l'ecouteur associe au 
bouton OK pourra se presenter ainsi (on suppose que cette methode appartient a la classe 
MonDialog) : 

public void actionPerformed (ActionEvent e) // reponse a 1' action sur OK 
{ if (e.getSource () == okBouton) 
{ ok = true ; 

setvisible (false) ; 

} 



Si nous avions introduit un bouton Cancel dans la boite de dialogue, il aurait fallu lui pre- 
voir un ecouteur charge, lui-aussi, de mettre fin au dialogue (setVisible(false)). En revan- 
che, aucune modification de OKn' aurait ete a prevoir. 



private JButton okBouton ; 
private JTextField champTexte ; 



setvisible (false) 



// met fin au dialogue et rend la boite invisible 




Remarque 
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5.2.3 Recuperation des informations 

Enfin, il faut pouvoir recuperer depuis la classe fenetre l'information saisie dans la boite de 
dialogue. Bien entendu, il s'agit la d'un probleme de conception et de programmation qui 
peut etre resolu de differentes manieres. Nous vous proposerons un peu plus loin un canevas 
general. Comme nous n'avons a recuperer qu'une seule valeur (de type String), nous pou- 
vons ici nous contenter de prevoir dans la classe MonDialog une methode (nommee lance- 
Dialog) destinee a la fois a lancer le dialogue et a fournir en resultat la chaine lue (ou la 
valeur null si la boite a ete fermee) 1 . Voici comment elle pourrait se presenter : 

public String lanceDialogue ( ) 
{ ok = false ; 

setvisible (true) ; 

if (ok) return champTexte . getText ( ) ; 
else return null ; 

} 

5.2.4 Gestion de I'objet boite de dialogue 

Le fait de rendre invisible une boite de dialogue ne libere pas I'objet correspondant, ni les 
composants qu'on a pu y introduire. Dans certains cas, cela peut poser des problemes de 
memoire. 

Mais la methode dispose permet de liberer une boite de dialogue, ainsi que les objets qui lui 
sont associes. 

Par ailleurs, lorsqu'un programme doit utiliser frequemment une meme boite de dialogue, on 
peut creer I'objet correspondant une seule fois et le rendre visible et invisible a volonte. 
Notez toutefois que, dans ce cas, les differents objets concernes ne sont pas liberes (mais ils 
ne sont crees qu'en un seul exemplaire). 

5.2.5 Exemple complet 

Voici un programme complet qui, suite a une action de l'utilisateur sur un bouton marque 
Lancement Dialogue, affiche une boite de dialogue du type MonDialog pour saisir un texte. 
La boite est creee et liberee (par dispose) a chaque fois 2 dans la methode actionPerformed. 
Le deroulement du dialogue proprement dit est gere par une methode lanceDialogue de la 
classe de la boite de dialogue. Les resultats (texte entre ou dialogue abandonne) s'affichent en 
fenetre console. 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 



1 . Nous aurions pu aussi, a l'image de ce que fait une methode telle que JOptionPane.showInputDialog, prevoir 
une methode independante chargee a la fois de creer I'objet boite de dialogue et de gerer le dialogue. 

2. Nous rencontrerons plus loin des exemples ou une boite de dialogue n'est creee qu'une seule fois pour toute 
la duree du programme. 
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class FenDialog extends JFrame implements ActionListener 
{ public FenDialog () 

{ setTitle ("Essai boite de dialogue") ; setSize (400, 200) ; 

lanceDial = new JButton ("Lancement dialogue") ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayout () ) ; contenu. add (lanceDial) ; 
lanceDial . addActionListener (this) ; 

} 

public void actionPer formed (ActionEvent e) 
{ MonDialog bd = new MonDialog(this) ; 
texte = bd . lanceDialogue () ; 

if (texte != null) System. out. println ("valeur lue : " + texte) ; 

else System. out. println ("dialogue abandonne") ; 

bd. disposed ; 

} 

private JButton lanceDial ; 
private String texte ; 

} 

class MonDialog extends JDialog implements ActionListener 
{ public MonDialog (JFrame proprio) 

{ super (proprio, "Dialogue de saisie", true) ; 

setSize (250, 120) ; 

okBouton = new JButton ("OK") ; 

okBouton . addActionListener (this) ; 

champTexte = new JTextField (20) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayout () ) ; 

contenu . add ( okBouton ) ; 

contenu. add (champTexte) ; 

} 

public void actionPer formed (ActionEvent e) 
{ if (e.getSource () == okBouton) 

{ ok = true ; setvisible (false) ; 

} 

} 

public String lanceDialogue ( ) 
{ ok = false ; 

setvisible (true) ; 

if (ok) return champTexte . getText ( ) ; 
else return null ; 

} 

private boolean ok ; 
private JButton okBouton ; 
private JTextField champTexte ; 

} 

public class Dialog2 

{ public static void main (String args[ ] ) 
{ FenDialog fen = new FenDialog ( ) ; 
fen . setvisible (true) ; 

} 
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valeur lue : Bonjour 
dialogue abandonne 
valeur lue : Hello 

Exemple d'une botte de dialogue de saisie d'un texte 

Remarques 

1 JDialog dispose d'un constracteur a deux arguments seulement, par exemple : 

JDialog (this, "Mon dialogue") 
Mais celui-ci fournit une boite de dialogue non modale. 

2 II est indispensable d'appeler setSize avant l'affichage de la boite de dialogue. 

Informations complementaires 

Nous avons vu qu'il est possible de ne pas prevoir de fenetre parent a une boite de dialo- 
gue. Dans ce cas, il suffit theoriquement de fournir une reference nulle en premier argu- 
ment du constructeur. Cependant, si vous utilisez un appel de la sorte : 

super (null, "Dialogue de saisie", true) ; 

vous aboutirez a un message de compilation a cause de son ambiguite. II existe en effet 
deux versions voisines du constructeur de JDialog, l'une avec un premier argument de 
type Frame, 1' autre avec un argument de type Dialog. Vous pouvez regler le probleme 
en forcant le type de cet argument, en ecrivant par exemple : 

super ( (Frame) null, "Dialogue de saisie", true) ; 
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5.3 Canevas general d' utilisation d'une boite de dialogue modale 

L'exemple precedent etait simple. Dans le cas le plus general, il faudra pouvoir : 

• transmettre des informations a la boite de dialogue afin qu'elle initialise les valeurs affi- 
chees par certains de ses controles, 

• recuperer les informations entrees par l'utilisateur dans la boite de dialogue, au moment de 
sa fermeture. 

Une facon d'y parvenir consiste a creer un objet, par exemple d'une classe Infos, destine a 
assurer cet archivage d' informations. En general, on pourra se contenter de champs publics 
representant les valeurs des controles concernes (en entree ou en sortie), meme si cela ne rea- 
lise pas d' encapsulation 1 . 

Voici un canevas general fonde sur cette demarche. Nous continuons a gerer le dialogue par 
une methode lanceDialogue de la classe boite de dialogue. Ici, nous prevoyons un bouton OK 
et un bouton Cancel. Cette fois, nous faisons en sorte que la boite de dialogue ne soit creee 
qu'une seule fois dans la methode de MaFenetre qui provoque Fouverture du dialogue (son 
nom n'est pas precise dans le canevas). 
class Infos 

{ // pour les informations a echanger avec la boite de dialogue 

} 

class MaFenetre extends JFrame implements ActionListener 
{ 

// instructions de declenchement du dialogue 

/* creation de la boite s' il y a lieu 
if (dialogue == null) { dialogue = new Dialogue (this) ; 

infos = new Infos () ; 

} 

/* initialisation des valeurs de 1' objet info a destination de la boite */ 



/* lancement dialogue * / 
dialogue . lanceDial ( infos ) ; 
/* recuperation nouvelles informations * / 



} 

private Dialogue dialogue ; 
private Infos infos ; 



} 

class Dialogue extends JDialog implements ActionListener 
{ public Dialogue ( ) // constructeur 

{ } 



1. Le cas echeant, on pourra toujours prevoir des champs prives et utiliser des methodes d'acces et d'alteration. 
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public void lance-Dial (Infos infos) 

{ /* initialisation des controles avec le contenu de infos */ 



/* lancer le dialogue * / 
ok = false ; 
setvisible (true) ; 
/* fin dialogue * / 

if (ok) { // recuperation informations des controles 

} 

} 

public void actionPerformed (ActionEvent e) 
{ if (e.getSource () == okBouton) 
{ ok = true ; 

setvisible (false) ; 

} 

if (e.getSource () == cancelBouton) 
setvisible (false) ; 

} 

private boolean ok = false ; 



6 Exemple d'application 

Voici une adaptation de F exemple d'application propose au chapitre precedent. Les controles 
separes ont ete regroupes dans une boite de dialogue qui apparait lorsque l'utilisateur agit sur 
un bouton MODIFICATIONS. Nous fournissons une image de la fenetre lorsque le dialogue 
est ferme, ainsi qu'une image de la boite de dialogue elle-meme. 

import javax. swing.* ; import java.awt.* ; import java.awt. event.* ; 
class MaFenetre extends JFrame implements ActionListener 
{ static public final String! ] nomCouleurs 

= { "rouge", "vert", "jaune", "bleu"} ; 

static public final Color[ ] couleurs 

= { Color. red, Color. green, Color .yellow, Color. blue) ; 

public MaFenetre () 

{ setTitle ("FIGURES AVEC BOITE DIALOGUE") ; 
setSize (450, 200) ; 

Container contenu = getContentPane ( ) ; 

/* panneau pour les dessins * / 
pan = new PaneauDessin () ; 
contenu . add (pan ) ; 

/* bouton pour lancer la boite de dialogue * / 
lanceDial = new JButton ( "MODIFICATIONS" ) ; 
contenu. add (lanceDial, "South") ; 
lanceDial . addActionListener (this) ; 

} 



6 - Exemple d'application 



415 



public void actionPerformed (ActionEvent ev) 
{ if (dialogue == null) 

{ dialogue = new Dialogue (this) ; 
infos = new Infos () ; 

} 

/* recup informations courantes dans 1' ob j et infos * / 
infos . largeur = pan . getLargeur ( ) ; 
infos . hauteur = pan . getHauteur ( ) ; 
infos . rectangle = pan . getRectangle ( ) ; 
infos . ovale = pan . getOvale ( ) ; 
infos . nomCouleur = pan . getNomCouleur ( ) ; 

/* lancement dialogue * / 
dialogue . lanceDial ( infos ) ; 

/* prise en compte nouvelles informations * / 
pan . setLargeur ( infos . largeur) ; 
pan . setHauteur (infos .hauteur) ; 
pan . setRectangle ( infos . rectangle ) ; 
pan.setOvale (infos. ovale) ; 
pan . setCouleur (infos .nomCouleur) ; 
pan . repaint ( ) ; 

} 

private PaneauDessin pan ; 
private JButton lanceDial ; 
private Dialogue dialogue ; 
private Infos infos ; 

} 

class Dialogue extends JDialog implements ActionListener 
{ public Dialogue (JFrame parent) 

{ super (parent, "COOLEDRS, FORMES, TAILLES", true) ; 
setSize (420, 100) ; 

Container contenu = getContentPane ( ) ; 
okBouton = new JButton ("OK") ; 
contenu. add (okBouton) ; 
contenu . setLayout (new FlowLayout () ) ; 
okBouton . addActionListener (this) ; 
cancelBouton = new JButton ("Cancel") ; 
contenu. add (cancelBouton) ; 
cancelBouton . addActionListener (this ) ; 

/* choix couleur * / 
comboCoulFond = new JComboBox (MaFenetre . nomCouleur s ) ; 
contenu. add (comboCoulFond) ; 

/* choix dimensions * / 
JLabel dim = new JLabel ("DIMENSIONS") ; 
contenu. add (dim) ; 
txtLargeur = new JTextField (5) ; 
contenu. add (txtLargeur) ; 
txtHauteur = new JTextField (5) ; 
contenu. add (txtHauteur) ; 

/* choix formes */ 
cOvale = new JCheckBox ("Ovale") ; 
contenu. add (cOvale) ; 
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cRectangle = new JCheckBox ("Rectangle") ; 
contenu . add (cRectangle) ; 

} 

public void lanceDial (Infos infos) 
{ /* placer infos dans controles * / 
txtLargeur . setText (""tinfos. largeur) ; 
txtHauteur . setText (""tinfos .hauteur) ; 
cOvale . setSelected (infos .ovale) ; 
cRectangle . setSelected ( infos . rectangle ) ; 
comboCoulFond . setSelectedltem (infos . nomCouleur ) ; 

/* lancer le dialogue * / 
ok = false ; 
setvisible (true) ; 

/* si ok on recupere les informations du dialogue * / 
if (ok) { infos . largeur = Integer .par selnt (txtLargeur. getText () ) ; 

infos . hauteur = Integer . parselnt (txtHauteur .getText () ) ; 
infos . rectangle = cRectangle . isSelected ( ) ; 
infos. ovale = cOvale. isSelected () ; 

inf os. nomCouleur = (String) comboCoulFond. getSelectedltem ( ) ; 

} 

} 

public void actionPerformed (ActionEvent e) 
{ if (e.getSource () == okBouton) 
{ ok = true ; 

setvisible (false) ; 

} 

if (e.getSource () == cancelBouton) 
setvisible (false) ; 

} 

private JButton okBouton, cancelBouton ; 
private boolean ok = false ; 
private JComboBox comboCoulFond ; 
private JTextField txtLargeur, txtHauteur ; 
private JCheckBox cOvale, cRectangle ; 

} 

class Infos 

{ public boolean ovale, rectangle ; 
public int largeur, hauteur ; 
public String nomCouleur ; 

} 

class PaneauDessin extends JPanel 
( public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 

if (ovale) g.drawOval (10, 10, 10 + largeur, 10 + hauteur) ; 

if (rectangle) g.drawRect (10, 10, 10 + largeur, 10 + hauteur) ; 

} 

public void setRectangle (boolean b) { rectangle = b ; } 
public boolean getRectangle () { return rectangle ; } 

public void setOvale (boolean b) { ovale = b ; } 
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public boolean getOvale () { return ovale ; } 

public void setLargeur (int 1) { largeur = 1 ; } 

public int getLargeur () { return largeur ; } 

public void setHauteur (int h) { hauteur = h ; } 

public int getHauteur () { return hauteur ; } 

public void setCouleur (String c) 

{ for (int i = 0 ; KMaFenetre . nomCouleurs . length ; i++) 

if (c == MaFenetre . nomCouleurs[ i] ) setBackground (MaFenetre . couleurs[ i] ) 
nomCouleur = c ; 

} 

public String getNomCouleur () { return nomCouleur ; } 

private boolean rectangle = false, ovale = false ; 
private int largeur=50, hauteur=50 ; 
private Color couleur ; 

private String nomCouleur = MaFenetre . nomCouleurs[ 0] ; 



public class ExDial 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 



fen. setvisible (true) ; 
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Les menus, les actions 
et les barres d'outils 



Java vous permet de doter une fenetre de menus deroulants. Comme dans la plupart des 
applications du commerce, vous disposerez de deux possibilites complementaires : 

• creer une barre de menus qui s'affichera en haut de la fenetre, et dans laquelle chaque menu 
pourra faire apparaitre une liste d' options ; 

• faire apparaitre a un moment donne ce qu'on nomme un menu surgissant, forme quant a lui 
d'une seule liste d'options. 

Nous commencerons par la premiere possibility, ce qui nous permettra d'exposer les princi- 
pes generaux de construction de menus et d' exploitation des evenements correspondants. 
Puis nous verrons comment utiliser des options de menus se presentant sous la forme de 
cases a cocher ou de boutons radio. Nous aborderons ensuite le cas particulier des menus sur- 
gissants. 

Nous apprendrons a acceder a une option de menu par le biais de lettres mnemoniques ou de 
combinaisons de touches nominees accelerateurs. Nous verrons comment eclairer l'utilisa- 
teur sur le role d'un composant par une bulle d' information. Nous apporterons ensuite quel- 
ques precisions concernant la dynamique des menus, c'est-a-dire 1' activation ou la 
deactivation d'une option lors de l'execution, ou encore l'introduction ou la suppression 
d'options. 

Enfin, nous vous montrerons comment la notion d' action facilite la realisation de codes dans 
lesquels une meme action peut etre provoquee de differentes manieres par l'utilisateur. 



Les menus, les actions et les barres d'outils 

Chapitre 15 



1 Les principes des menus deroulants 

Nous allons vous presenter les principes des menus deroulants en considerant le cas le plus 
usuel, c'est-a-dire celui oil ils sont rattaches a une barre de menus. 

1.1 Creation 

Ces menus deroulants usuels font intervenir trois sortes d'objets : 

• un objet barre de menus (JMenuBar), 

• differents objets menu (JMenu) qui seront visibles dans la barre de menus, 

• pour chaque menu, les differentes options, de type JMenuItem, qui le constituent. 
La creation d'un objet barre de menus se fait ainsi : 

JMenuBar barreMenus = new JMenuBar ( ) ; 

Cette barre sera rattachee a une fenetre/en par : 

fen . set JMenuBar (barreMenus ) ; / / rattache 1' obj et barreMenus a la f enetre fen 

Les differents objets menus sont crees par appel d'un constructeur de JMenu, auquel on four- 
nit le nom du menu, tel qu'il figurera dans la barre. Chaque objet menu est ajoute a la barre 
par add (il apparait dans l'ordre oil il a ete ajoute) ; par exemple : 

JMenu couleur = new JMenu ("Couleur") ; // cree un menu de nom Couleur 
barreMenus . add (couleur) ; // 1' ajoute a barreMenus 

Enfin, les differentes options d'un menu sont creees par appel d'un constructeur de JMenuI- 
tem, auquel on fournit, la encore, le nom de 1' option telle qu'elle apparaitra lorsque l'utilisa- 
teur fera s'afficher le contenu du menu. Chaque option est ajoutee a un menu par add. Par 
exemple : 

JMenuItem rouge = new JMenuItem ("Rouge") ; // cree une option de nom Rouge 
couleur. add (rouge) ; // 1' ajoute au menu couleur 

Voici comment on pourrait creer, dans le constructeur d'une fenetre, une barre de menus 
comportant deux menus : Couleur (forme des options Rouge et Vert) et Dimensions (forme 
des options Hauteur et Largeur) : 

private JMenuBar barreMenus ; 

private JMenu couleur, dimensions ; 

private JMenuItem rouge, vert, largeur, hauteur ; 



barreMenus = new JMenuBar ( ) ; 
set JMenuBar (barreMenus ) ; 

/* creation menu Couleur et ses options Rouge et Vert * / 
couleur = new JMenu ("Couleur") ; 
barreMenus. add (couleur) ; 
rouge = new JMenuItem ("Rouge") ; 
couleur. add (rouge) ; 
vert = new JMenuItem ("Vert") ; 
couleur . add (vert ) ; 
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/* creation menu Dimensions et ses options Hauteur et Largeur * / 
dimensions = new JMenu ("Dimensions") ; 
barreMenus. add (dimensions) ; 
largeur = new JMenuItem ("Largeur") ; 
dimensions. add (largeur) ; 
hauteur = new JMenuItem ("Hauteur") ; 
dimensions. add (hauteur) ; 

1.2 Evenements generes 

Chaque action sur une option (JMenuItem) genere un evenement Action qu'on peut traiter en 
associant un ecouteur a Fobjet correspondant. Dans la methode actionPerformed de cet ecou- 
teur, l'option concernee pourra etre identifiee classiquement par la methode getSource de la 
classe ActionEvent. On pourra aussi, le cas echeant, recourir a getActionCommand qui, 
comme pour un bouton, fournit la chaine de commande associee a l'option. Par defaut, il 
s'agit du nom de l'option (fournie au constructeur de JMenuItem) mais, la encore, celle-ci 
pourrait etre modifiee par setActionCommand. 

1.3 Exemple 

Voici un exemple de programme dans lequel nous creons une barre de menus comportant les 
deux menus precedents Couleur (options Rouge et Vert) et Dimensions (options Hauteur et 
Largeur). Ici, nous nous contentons de "tracer" en fenetre console les differentes actions de 
l'utilisateur sur les options, en fournissant chaque fois la source concernee et la chaine de 
commande correspondante. 

import j ava . awt . * ; 
import j ava. awt. event.* ; 
import javax. swing.* ; 
import javax. swing. event.* ; 

class FenMenu extends JFrame implements ActionListener 
{ public FenMenu () 

{ setTitle ("Exemple de menu") ; 

setSize (300, 150) ; 

/* creation barre des menus * / 

barreMenus = new JMenuBar ( ) ; 

set JMenuBar (barreMenus) ; 

/* creation menu Couleur et ses options Rouge et Vert * / 

couleur = new JMenu ("Couleur") ; 

barreMenus . add (couleur ) ; 

rouge = new JMenuItem ("Rouge") ; 

couleur . add ( rouge ) ; 

rouge. addActionListener (this) ; 

vert = new JMenuItem ("Vert") ; 

couleur . add (vert) ; 

vert. addActionListener (this) ; 



Les menus, les actions et les barres d'outils 

Chapitre 15 



/* creation menu Dimensions et ses options Hauteur et Largeur * / 
dimensions = new JMenu ("Dimensions") ; 
barreMenus . add (dimensions ) ; 
largeur = new JMenuItem ("Largeur") ; 
dimensions . add (largeur) ; 
largeur .addActionListener (this) ; 
hauteur = new JMenuItem ("Hauteur") ; 
dimensions . add (hauteur) ; 
hauteur .addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent e) 
{ Object source = e . getSource ( ) ; 

System. out .println ("Action avec chaine de commande = " 
+ e . getActionCommand ( ) ) ; 

if (source == rouge) System. out. println ("** Action option rouge") ; 

if (source == vert) System. out. println ("** Action option vert") ; 

if (source == largeur) System. out. println ("** Action option largeur") ; 

if (source == hauteur) System. out. println ("** Action option hauteur") ; 

} 

private JMenuBar barreMenus ; 

private JMenu couleur, dimensions ; 

private JMenuItem rouge, vert, largeur, hauteur ; 

} 

public class Menul 

( public static void main (String args[ ] ) 
{ FenMenu fen = new FenMenu ( ) ; 
fen . setvisible (true) ; 

} 
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Creation de menus et gestion des evenements correspondants 

Remarques 

1 Dans un menu, il est possible d'introduire une barre separatrice entre deux options, en 
recourant a la methode addSeparator de la classe JMenu ; par exemple : 

dimensions . addSeparator ( ) ; 
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2 Ici, la barre de menus a ete rattachee a la fenetre des sa creation (elle est encore vide). 
Mais nous aurions pu le faire plus tard, par exemple apres la creation des differents 
menus. II est meme possible de changer de barre de menus pendant l'execution du pro- 
gramme. 

3 Nous n'avons parle que des evenements generes par les options elles-memes. En toute 
rigueur, les menus (JMenu) generent des evenements de la categorie MenuEvent lors de 
leur affichage ou lors de leur disparition. L'ecouteur correspondant est ajoute par add- 
MenuListener et il doit implementer 1' interface MenuListener contenant les trois 
methodes (il n'y a pas d' adaptateur) : menuSelected, menuDeselected et menuCance- 
led. En pratique, ces possibilites sont peu utilisees. Sur le site Web d' accompagnement, 
vous trouverez sous le nom Menula.java une adaptation du programme precedent tra- 
cant ces evenements MenuEvent. 



6 



Informations complementaires 

II est possible de faire figurer a cote du nom d'options un petit pictogramme qu'on 
nomme souvent une icone. Celle-ci peut etre fournie comme second argument du cons- 
tructeur de l'option, sous la forme du nom d'un fichier au format .gif, Cette posibilite 
n'existe que pour les options de type JMenuItem ; elle n'est done pas disponible pour les 
boutons radio ou les cases a cocher. 



2 Les differentes sortes d'options 

Au paragraphe precedent, nous vous avons presente les options de type JMenuItem qui sont 
les plus usuelles. Mais on peut aussi utiliser dans un menu : 

• des options cases a cocher, e'est-a-dire des objets de type JCheckBoxMenuItem, 

• des options boutons radio, e'est-a-dire des objets de type JRadioButtonMenuItem. 

On les ajoute par add a un menu, de la meme maniere que les options usuelles. 

Les options boutons radio peuvent, comme les boutons radio, etre placees dans un groupe 
(objet de type ButtonGroup) de maniere a assurer l'unicite de la selection a l'interieur du 
groupe. 

Les evenements generes par ces nouvelles options sont les memes que ceux generes par les 
boutons correspondants (presentes au chapitre 13). Autrement dit : 

• chaque modification d'une option case a cocher genere a la fois un evenement Act ion et un 
evenement Item ; 

• chaque action sur une option bouton radio r d'un groupe provoque : 

- un evenement Action et un evenement Item pour r (qu'elle soit ou non selectionnee), 
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- un evenement Item pour F option precedemment selectionnee dans le groupe, si celle- 
ci existe et si elle differe de r. 

Rappelons que les evenements Item sont traites par la methode itemStateChanged. 

On voit que pour les options bouton radio, F evenement Item prend une signification diffe- 
rente de F evenement Action puisqu'il permet de cerner les changements d'etats. 

Dans tous les cas, on pourra recourir a la methode isSelected (de la classe JRadioButtonMe- 
nultem ou JCheckBoxMenuItem) pour savoir si une option est selectionnee. 

On notera que les options usuelles d'un menu devaient obligatoirement etre traitees au 
moment de leur selection. En revanche, avec les options cases a cocher ou boutons radio, on 
dispose de plus de liberte. On peut, en effet, les traiter comme les options usuelles mais on 
peut aussi se contenter de s'interesser a leur etat a un moment donne. Ce serait par exemple le 
cas de boutons radio permettant de selectionner une "couleur courante" se trouvant utilisee 
ulterieurement dans un trace. Bien entendu, si ces memes boutons servent a modifier la cou- 
leur d'un paneau, il sera preferable que leur prise en compte soit immediate. 

Voici une adaptation du programme precedent, dans lequel le premier menu Couleur est 
forme d' options boutons radio (appartenant a un meme groupe), tandis que le second menu 
Dimensions a ete remplace par un menu Formes forme d' options cases a cocher. Ici, nous 
traitons a la fois les evenements Action et Item et nous affichons Fetat des options (par souci 
de simplicite, nous n' affichons plus la valeur de la chaine de commande associee a un evene- 
ment A ction). 



import j ava . awt .* ; 
import j ava. awt. event.* ; 
import javax. swing.* ; 
import javax. swing. event.* ; 



class FenMenu extends JFrame implements ActionListener, ItemListener 
{ public FenMenu () 

{ setTitle ("Exemple de menu") ; 
setSize (300, 150) ; 

/* creation barre des menus * / 
barreMenus = new JMenuBar ( ) ; 
set JMenuBar (barreMenus ) ; 

/* creation menu Couleur et son groupe de 2 boutons radio : Rouge et Vert * / 
couleur = new JMenu ("Couleur") ; 
barreMenus . add (couleur) ; 

rouge = new JRadioButtonMenuItem ("Rouge") ; 

couleur . add ( rouge ) ; 

rouge. addActionListener (this) ; 

rouge. addltemListener (this) ; 

vert = new JRadioButtonMenuItem ("Vert") ; 

couleur . add (vert ) ; 

vert. addActionListener (this) ; 

vert. addltemListener (this) ; 

ButtonGroup groupe = new ButtonGroup ( ) ; 
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groupe . add ( rouge ) ; 
groupe . add ( vert ) ; 

/* creation menu Dimensions et ses cases a cocher Hauteur et Largeur * / 
formes = new JMenu ("Formes") ; 
barreMenus. add (formes) ; 

rectangle = new JCheckBoxMenuItem ("Rectangle") ; 

formes. add (rectangle) ; 

rectangle . addActionListener (this) ; 

rectangle. addltemListener (this) ; 

ovale = new JCheckBoxMenuItem ("Ovale") ; 

formes. add (ovale) ; 

ovale . addActionListener (this) ; 

ovale. addltemListener (this) ; 

} 

public void actionPer formed (ActionEvent e) 
{ Ob j ect source = e . getSource ( ) ; 

if (source == rouge) System. out. println ("** 

if (source == vert) System. out. println ("** 

if (source == rectangle) System. out. println ("** 

if (source == ovale) System. out. println ("** 

} 

public void itemStateChanged (ItemEvent e) 
{ Ob j ect source = e . getSource ( ) ; 

if (source == rouge) System. out. println 

if (source == vert) System. out. println 

if (source == rectangle) System. out. println 

if (source == ovale) System. out. println ( 

System. out. print ("Options selectionnees : ") 

if (rouge. isSelected () ) System. out. print 

if (vert. isSelected () ) System. out. print 

if ( rectangle. isSelected () ) System. out. print 

if (ovale. isSelected () ) System. out. print 

System. out .println ( ) ; 



("** 



Action option rouge") ; 
Action option vert") ; 
Action option rectangle") 
Action option ovale") ; 



Item option rouge") ; 
Item option vert") ; 
Item option rectangle") 
Item option ovale") ; 



(" rouge") ; 
(" vert") ; 
(" rectangle" 
(" ovale") ; 



private JMenuBar barreMenus ; 

private JMenu couleur, formes ; 

private JRadioButtonMenuItem rouge, vert ; 

private JCheckBoxMenuItem rectangle, ovale ; 



public class Menu2 

{ public static void main (String args[ ] ) 
{ FenMenu fen = new FenMenu ( ) ; 
fen . setvisible (true) ; 

} 

) 



** Item option rouge 
Options selectionnees : rouge 
** Action option rouge 
** Item option rectangle 
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Options selectionnees : rouge rectangle 
** Action option rectangle 
** Item option rouge 

Options selectionnees : vert rectangle 
** Item option vert 

Options selectionnees : vert rectangle 

** Action option vert 

** Item option rectangle 

Options selectionnees : vert 

** Action option rectangle 

** Item option ovale 

Options selectionnees : vert ovale 



** Action option ovale 
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Creation et exploitation de menus comportant des boutons radio et des cases a cocker 

3 Les menus surgissants 

Nous venons de voir comment utiliser des menus usuels, c'est-a-dire rattaches a une bane de 
menus et done affiches en permanence dans la fenetre. Java vous permet egalement d'utiliser 
ce qu'on nomme des menus surgissants, c'est-a-dire des menus (sans nom) dont la liste 
d'options apparait suite a une certaine action de Futilisateur, en general un clic sur le bouton 
droit de la souris. 

Pour ce faire, il vous suffit de creer un objet de type JPopupMenu, auquel vous rattachez des 
objets de type JMenuItem, exactement comme vous l'auriez fait avec un objet de type 
JMenu 1 . Voici par exemple comment creer un menu surgissant comportant deux options 
Rouge et Vert : 

JPopupMenu couleur = new JPopupMenu () ; // creation objet menu surgissant 

JMenuItem rouge = new JMenuItem ("Rouge") ; // creation option Rouge 
couleur. add (rouge) ; // ajout au menu surgissant 

JMenuItem vert = new JMenuItem ("Vert") ; // creation option Vert 
couleur. add (vert) ; // ajout au menu surgissant 



1. Toutefois, contrairement a ce qui se passe avec JMenu, aucun libelle n'est associe a un menu surgissant. 
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On pourra aussi utiliser des options cases a cocher ou boutons radio. 

Un menu usuel est affiche en permanence. Un menu surgissant doit etre affiche explicitement 
par le programme, en utilisant la methode show de la classe JPopupMenu. Celle-ci necessite 
qu'on lui precise en arguments : 

• le composant concerne (en general, il s'agira d'une fenetre), 

• les coordonnees auxquelles on souhaite faire apparaitre le menu (il s'agit de celles de son 
coin superieur gauche). 

Par exemple, si fen est une fenetre : 

couleur.show (fen, x, y) ; // affiche le menu aux coordonnees x, y 

Le menu restera affiche jusqu'a ce que l'utilisateur selectionne une option ou encore qu'il 
ferme le menu en cliquant a cote. 

Les evenements generes par les options d'un menu surgissant restent les memes que ceux que 
nous avons deja rencontres {Action et eventuellement Item) 1 . 

On sera souvent amene a afficher un menu surgissant a la suite d'un clic sur le bouton droit 
de la souris. Pour vous faciliter les choses, la classe MouseEvent dispose d'une methode 
isPopupTrigger qui fournit la valeur true si le bouton concerne est celui traditionnellement 
reserve aux menus surgissants. Cependant, cette methode n'est utilisable que dans mouseRe- 
leased, ce qui n'est guere penalisant si Ton s'en tient a l'usage qui veut qu'on affiche le menu 
au moment du relachement du bouton et non avant. En definitive, on sera souvent amene a 
utiliser une methode mouseReleased se presentant ainsi (fen designant la fenetre concernee) : 

{ public void mouseReleased (MouseEvent e) 
{ if ( e . i s PopupTr igger ( ) ) 



Detecter l'evenement mouseReleased n'est pas tout a fait equivalent a detecter l'evene- 
ment mouseClicked. En effet, seul le premier se produit si Ton a fait glisser la souris entre 
l'appui sur un bouton et son relachement. 



Voici un exemple de programme qui affiche un menu surgissant comportant deux options 
Rouge et Vert, a la suite d'un clic droit (relachement) dans la fenetre. II trace en fenetre con- 
sole les actions sur les options. 

Ici, nous avons choisi d' utiliser comme ecouteur de souris une classe anonyme derivee de 
MouseAdapter. Dans la methode mouseReleased, nous allons done afficher par show le menu 



couleur . show ( fen, e . getx ( ) , e . getY ( ) ) 



Remarque 



Exemple 



1 . En revanche, contrairement aux menus de type JMenu, les menus de type JPopupMenu ne generent pas 
d'evenement de type MenuEvent. 
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surgissant voulu ; pour cela, nous devons disposer de la reference de la fenetre concemee. 
Nous pouvons l'obtenir grace a la methode getComponent de la classe MouseEvent, laquelle 
foumit le composant (objet de type Component ou derive) concerne par l'evenement. 



import j ava . awt .* ; 
import j ava. awt. event.* ; 
import javax. swing.* ; 
import javax. swing. event.* ; 



class FenMenu extends JFrame implements ActionListener 
{ 

public FenMenu () 

{ setTitle ("Exemple de menu surgissant") ; setSize (400, 120) ; 

/* creation menu surgissant Couleur et ses options Rouge et Vert * / 
couleur = new JPopupMenu () ; 
rouge = new JMenuItem ("Rouge") ; 
couleur . add ( rouge ) ; 
rouge. addActionListener (this) ; 
vert = new JMenuItem ("Vert") ; 
couleur . add (vert ) ; 
vert. addActionListener (this) ; 
addMouseListener (new MouseAdapter ( ) 

{ public void mouseReleased (MouseEvent e) 
{ if (e.isPopupTrigger () ) 

couleur . show (e . getComponent ( ) , e . getx ( ) , e . getY ( ) ) ; 

} 

} ) ; 



public void actionPerformed (ActionEvent e) 
{ Ob j ect source = e . getSource ( ) ; 

System. out .println ("Action avec chaine de commande = " 
+ e . getActionCommand ( ) ) ; 

if (source == rouge) System. out. println ("** Action option rouge") ; 

if (source == vert) System. out. println ("** Action option vert") ; 

} 

private JPopupMenu couleur ; 
private JMenuItem rouge, vert ; 



public class Popupl 

( public static void main (String args[ ] ) 
{ FenMenu fen = new FenMenu ( ) ; 
fen . setvisible (true) ; 

} 

) 
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Exemple de menu surgissant 

Remarques 

1 Rappelons que les methodes getComponent et getSource fournissent la meme reference, 
mais la premiere est de type Object tandis que la seconde est de type Component. A la 
place de l'appel : 

couleur . show (e . getComponent ( ) , e . getx ( ) , e . getY ( ) ) ; 

nous aurions pu utiliser : 

couleur. show ( (Component) e. getSource () , e.getXQ, e.getY(J) ; 

2 A l'instar des menus usuels, les menus surgissants generent des evenements lors de leur 
affichage ou de leur disparition. Cette fois, il s'agit d'evenements de la categorie 
JPopupMenuEvent ; l'ecouteur correspondant est ajoute par addPopupMenuListener ; il 
implemente l'interface PopupMenuListener, comportant les methodes popupMenuWill- 
BecomeVisible, popupMenuWMBecomelnvisible et popupMenuCanceled. 

4 Raccourcis clavier 

Dans de nombreuses d' applications du commerce, il est possible de selectionner un menu ou 
une option d'un menu en frappant une touche ou une combinaison de touches qu'on nomme 
alors raccourci clavier. II existe deux sortes de raccourcis clavier : 

• les caracteres mnemoniques, 

• les accelerate urs. 

4.1 Les caracteres mnemoniques 

Le caractere mnemonique est un caractere (unique) souligne dans un nom de menu ou 
d'option. On agit sur un menu de caractere mnemonique C en frappant la combinaison Alt/C. 
On agit sur une option de caractere mnemonique C, en frappant tout simplement ce caractere, 
alors que le menu contenant cette option est affiche. 
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Pour associer un caractere mnemonique a un menu ou a une option, on utilise la methode 
setMnemonic de la classe AbstractButton (dont derivent, entre autre, les classes menus et 
options de menus) par exemple : 

JMenu couleur = new JMenu ("Couleur") ; 

couleur . setMnemonic (' C ) ; / / C = caractere mnemonique du menu Couleur 
JMenuItem rouge = new JMenuItem ("Rouge") ; 

rouge . setMnemonic (' R' ) ; / / R = caractere mnemonique de 1' option Rouge 

On peut aussi preciser le caractere mnemonique lors de la construction de l'objet JMenu 
(attention : cela ne s'applique pas aux options de menus) par exemple : 

JMenu couleur = new JMenu ("Couleur", ' C ) ; 

Notez que Java ne verifie pas si le caractere mnemonique mentionne appartient bien au nom 
du menu. Si ce n'est pas le cas, aucun caractere ne sera souligne et, bien entendu, le caractere 
mnemonique concerne ne sera pas exploitable. Par ailleurs, si plusieurs options d'un meme 
menu se voient attribuer le meme caractere mnemonique, seul le premier sera exploitable par 
ce biais. 

4.2 Les accelerateurs 

II s'agit cette fois d'une combinaison de touches qu'on associe a une option (jamais a un 
menu) et qui s'affiche a droite de son nom. II suffit que l'utilisateur frappe cette combinaison 
de touches pour provoquer la selection de l'option correspondante et ce, independamment de 
ce qui s'affiche dans la fenetre a ce moment-la. 

Pour associer une telle combinaison de touches a une option, on utilise la methode setAccele- 
rator de la classe JMenuItem, a laquelle on fournit, en argument, la combinaison de touches 
voulue. Pour ce faire, on utilise une methode statique getKeyStroke (de la classe Keystroke) 
de la facon suivante : 

Keystroke. getKeyStroke (KeyEvent.VK_R, // touche r 

InputEvent . CTRL_MASK) // + touche CTRL 

Le premier parametre (ici KeyEvent.VK_R) correspond a ce qu'on nomme le code de touche 
virtuelle de la touche r. Cette notion sera etudiee en detail au paragraphe 2.2 du chapitre 16. 
Pour F instant, sachez simplement qu'a chaque touche du clavier (lettre, chiffre, mais aussi 
touche de fonction, Fl, F2, Delete, End...) correspond une constante entiere nommee code de 
touche virtuelle. Quant au second parametre, il correspond aux touches modificatrices, c'est- 
a-dire a une ou plusieurs touches parmi Shift, Ctrl, Alt. II utilise les constantes de la classe 
InputEvent qui seront presentees au paragraphe 2.4 du chapitre 16 ; par exemple, nous ver- 
rons que InputEvent. CTRL _M ASK correspond a la touche Ctrl. 

Voici comment nous pouvons associer la combinaison CTRL/R a une option rouge : 

JMenuItem rouge = new JMenuItem ("Rouge") ; 

rouge . setAccelerator (Keystroke . getKeyStroke (KeyEvent . VK_R, 

InputEvent . CTRLJ4ASK) ) ; 
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4.3 Exemple 

Voici comment nous pourrions modifier les instructions de creation du menu Couleur du pro- 
gramme de 1' exemple de programme du 1.3 pour que : 

• le menu Couleur dispose du mnemonique C, 

• F option Rouge dispose du mnemonique R et de 1' accelerateur CTRL/R, 

• F option Vert dispose du mnemonique Vet de F accelerateur CTRL/V. 

I* creation menu Couleur et ses options Rouge et Vert * / 
couleur = new JMenu ("Couleur") ; couleur . setMnemonic (' C ) ; 
barreMenus. add (couleur) ; 
rouge = new JMenuItem ("Rouge") ; 
rouge . setMnemonic (' R' ) ; 

rouge . set-Accelerator (Keystroke. getKeyStroke (KeyEvent.VK_R, 

InputEvent . CTRL_MASK) ) ; 

couleur . add ( rouge ) ; 

rouge . addActionListener (this) ; 

vert = new JMenuItem ("Vert") ; vert . setMnemonic (' V ) ; 
vert . setAccelerator (Keystroke . getKeyStroke (KeyEvent . VK_V, 

InputEvent. CTRL_MASK) ) ; 

couleur . add (vert) ; 

vert. addActionListener (this) ; 

Le programme complet figure sur le site Web d' accompagnement sous le nom Accel.java. 
Voici un exemple d' execution : 



I^Exemple accelerateurs 1 


Couleur | Dimensions 


Rouge ctrl+R 




Vert 









Remarques 

1 La methode setMnemonic est en fait heritee de la classe AbstractButton, ce qui signifie 
qu'on peut aussi l'appliquer a des boutons radio ou des cases a cocher. 

2 Par nature, un accelerateur est forme d'une touche quelconque (premier parametre de 
getKeyStroke), associee eventuellement a une ou plusieurs touches modificatrices. II 
n'est done pas possible d'utiliser par exemple la combinaison de deux touches usuelles 
comme A et E. En revanche, bien que cela ne soit pas l'usage, on pourrait utiliser une 
combinaison de la forme Ctrl/F5 (premier argument VK_F5, deuxieme argument Input- 
Event. CTRLJA ASK). 
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3 Le choix des differents accelerateurs utilises dans une application doit etre fait avec 
soin. En particulier, il faut absolument eviter d'utiliser deux fois la meme combinaison 
de touches. Dans ce cas, Java ne vous fournirait pas de message particulier ; simple- 
ment, vous ne pourriez exploiter que le premier accelerateur ainsi defini. 

4 L' aspect majuscules/minuscules n'intervient pas dans la notion de touche virtuelle, qui 
correspond a une touche du clavier et non a un caractere. 



5 Les bulles d'aide 

Dans la plupart des applications professionnelles, un petit rectangle (nomme tooltip en 
anglais) contenant un bref texte explicatif apparait lorsque vous laissez un instant la souris 
sur certains composants (boutons, menus...). Java vous permet d'obtenir un tel affichage pour 
n'importe quel composant. II vous suffit pour cela de lui associer le texte voulu a Faide de la 
methode setToolTipText, comme dans cet exemple applique a Fune des options rouge des 
paragraphes precedents : 

rouge . setToolTipText ("fond rouge") ; 
A titre indicatif, voici comment nous pourrions modifier la creation du menu Couleur de 
l'exemple du paragraphe 1.3, afin d'associer des bulles d'aide a ses deux options : 

/* creation menu Couleur et ses options Rouge et Vert * / 
couleur = new JMenu ("Couleur") ; 
barreMenus . add (couleur) ; 
rouge = new JMenuItem ("Rouge") ; 
rouge . setToolTipText ("fond rouge") ; 
couleur . add ( rouge ) ; 
rouge. addActionListener (this) ; 
vert = new JMenuItem ("Vert") ; 
vert . setToolTipText ("fond vert") ; 
couleur . add (vert ) ; 
vert. addActionListener (this) ; 

Le programme complet ainsi modifie figure sur le site Web d'accompagnement sous le nom 
Tooltip.java. Voici un exemple d'execution montrant l'apparition de la bulle relative a 
1' option Vert : 



|g*Exem| 


lie de menu 
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Remarque 

Les bulles d'aide ont ete presentees a propos des options de menu, mais elles s'appliquent 
en fait a n'importe quel composant. 

6 Composition des options 

Dans les exemples precedents, un menu etait forme d'une simple liste d' options. En fait, dans 
de nombreuses applications, une option peut a son tour faire apparaitre une liste de sous- 
options. Pour obtenir ce resultat avec Java, il vous suffit d'utiliser dans un menu une option 
qui soit non plus de type JMenuItem, mais de type JMenu (comme le menu lui-meme). Vous 
pouvez alors rattacher a ce sous-menu les options de votre choix. La demarche peut etre repe- 
tee autant de fois que vous le voulez. 

6.1 Exemple avec des menus deroulants usuels 

Voici un premier exemple dans lequel la barre des menus ne contient qu'un seul menu For- 
mes constitue : 

• d'une option Arrondi (de type JMenu) formee elle-meme de deux options Cercle et Ovale 
(de type JMenuItem), 

• d'une option usuelle Rectangle (de type JMenuItem). 

import java.awt.*; import j ava . awt . event . * ; 
import javax. swing.* ; import javax. swing. event.* ; 
class FenMenu extends JFrame 
{ public FenMenu () 

{ setTitle ("Exemple de menus composes") ; setSize (400, 150) ; 
/* creation barre des menus * / 

barreMenus = new JMenuBarQ ; set JMenuBar (barreMenus) ; 

/* creation menu Formes et ses options Arrondi et Rectangle * / 

formes = new JMenu ("Formes") ; 

barreMenus. add (formes) ; 

arrondi = new JMenu ("Arrondi") ; 

formes. add (arrondi) ; 

cercle = new JMenuItem ("Cercle") ; 

arrondi . add (cercle ) ; 

ovale = new JMenuItem ("Ovale") ; 

arrondi. add (ovale) ; 

rectangle = new JMenuItem ("Rectangle") ; 
formes. add (rectangle) ; 

} 

private JMenuBar barreMenus ; 

private JMenu formes, arrondi ; 

private JMenuItem cercle, ovale, rectangle ; 

} 
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public class Compos 

{ public static void main (String args[ ] ) 
{ FenMenu fen = new FenMenu ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Exemple de menu usuel compose 

Notez la presence d'un triangle a la droite d'une option pour montrer qu'elle est composee 
d'autres options. 

6.2 Exemple avec un menu surgissant 

Voici un second exemple dans lequel nous creons un menu surgissant, compose de la meme 
maniere que le menu Formes precedents : 

import java.awt.*; import java.awt. event.* ; 
import javax. swing.* ; import javax. swing. event.* ; 
class FenMenu extends JFrame 
{ public FenMenu () 

{ setTitle ("Exemple de menu surgissant") ; setSize (400, 120) ; 

/* creation menu surgissant Couleur et ses options Rouge et Vert * / 

formes = new JPopupMenu () ; 

arrondi = new JMenu ("Arrondi") ; 

formes . add (arrondi ) ; 

cercle = new JMenuItem ("Cercle") ; 

arrondi. add (cercle) ; 

ovale = new JMenuItem ("Ovale") ; 

arrondi. add (ovale) ; 

rectangle = new JMenuItem ("Rectangle") ; 
formes . add (rectangle) ; 
addMouseListener (new MouseAdapter ( ) 

{ public void mouseReleased (MouseEvent e) 
{ if (e.isPopupTrigger () ) 

formes. show (e.getComponent () , e.getXQ, e.getYO) ; 

} 

} ) ; 

} 
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private JPopupMenu formes ; 
private JMenu arrondi ; 

private JMenuItem cercle, ovale, rectangle ; 

1 

public class Compos2 

{ public static void main (String args[ ] ) 
{ FenMenu fen = new FenMenu ( ) ; 
fen. setvisible (true) ; 



Dans les exemples precedents, les menus (usuels ou surgissants) etaient crees une fois pour 
toutes, de sorte qu'ils presentaient toujours les memes options et que celles-ci etaient tou- 
jours actives. En fait, Java vous permet : 

• de desactiver et de reactiver a volonte n'importe quelle option : une option desactivee appa- 
rait en brillance attenuee et elle est insensible a une action de l'utilisateur ; 

• de modifier le contenu d'un menu pendant l'execution. 



7.1 Activation et deactivation d'options 



La methode setEnabled permet d'activer ou de desactiver un menu ou une option 1 : 

JMenu couleur ; 
JMenuItem Rouge ; 



couleur . setEnabled (false) ; // desactive le menu couleur 




Arrondi *\ cercle 



Rectangle ovale 



Exemple de menu surgissant compose 



7 Menus dynamiques 



couleur . setEnabled ( true ) 
rouge . setEnabled (false) 
rouge . setEnabled (true) ; 



// (re) active le menu couleur 
/ / desactive 1' option rouge 
// (re) active 1' option rouge 



1. En fait, cette methode est heritee de la classe JComponent. Nous l'avons deja appliquee a des boutons. 
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Elle peut etre executee a n'importe quel moment. En particulier, on peut l'appliquer a une 
option, meme si le menu correspondant n'est pas affiche. 

Dans un gros programme, on peut se trouver gene par la dispersion dans le code des opera- 
tions d' activation et de deactivation des options. Dans ces conditions, on peut chercher a 
conserver un etat des differentes options et n'activer les options voulues qu'au moment ou 
Putilisateur selectionne le menu correspondant. Cela est possible dans le cas des options de 
menus usuels, en utilisant l'evenement MenuEvent dont nous avons deja parle (mais rien de 
comparable n'existe pour les options de menus surgissants). En fait, nous verrons que les 
objets de type AbstractAction fourniront une solution plus elegante et plus generale : il suffira 
d'activer Taction pour activer toutes les options associees. 

7.2 Modification du contenu d'un menu 

En pratique, cette seconde possibilite est rarement utilisee et ce pour d'evidentes raisons 
ergonomiques. En effet, il n'est guere appreciable pour l'utilisateur de voir les options d'un 
menu apparaitre et disparaitre au fil de 1' execution. En fait, il est beaucoup plus raisonnable 
de se limiter aux possibilites d' activation et de deactivation exposees precedemment. 

A titre indicatif, sachez que vous disposez (aussi bien pour JMenu que pour JPopupMenu) 
des methodes insert (insertion d'options) et remove (suppression d'options) dont vous trou- 
verez les en-tetes en annexe E. 



8 Les actions 

Dans une application de taille importante, il existe souvent plusieurs manieres de declencher 
une meme action. Par exemple, une couleur de fond pourra etre selectionnee a la fois par un 
menu deroulant usuel et par un menu surgissant. 

Si Ton souhaite realiser des logiciels de qualite, il est preferable que le traitement d'une 
action donnee (telle que le changement de couleur) ne soit realise qu'en un seul point du 
code. On peut deja tendre vers cet ideal en faisant en sorte que les ecouteurs appropries se 
contentent d'appeler une methode unique responsable de Faction en question. En general, 
cependant, cela ne sera pas suffisant et il faudra s'acheminer vers la creation d'objets abs- 
traits encapsulant toutes les informations necessaires a la realisation d'une action (par exem- 
ple couleur, mais aussi ancienne couleur, composant concerne...). 

C'est la precisement que Java offre un outil tres puissant, a savoir la classe AbstractAction 
qui comporte deja les services de base qu'on peut attendre d'une classe destinee a representer 
une telle action. Bien entendu, on pourra la completer a volonte par derivation. 

Compte tenu de la puissance de cette classe AbstractAction, nous introduirons ses possibilites 
a travers quelques exemples progressifs avant d'en examiner les proprietes generales. 
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8.1 Presentation de la notion d'action abstraite 

Pour vous montrer comment utiliser la classe AbstractAction, nous commencerons par un 
exemple dans lequel une action n'est realisee que par un seul composant. 

8.1.1 Definition d'une classe action 

Nous allons tout d'abord creer une classe destinee a representer une action abstraite du type 
choix d'une couleur. Une telle action est caracterisee par un nom (String) qu'on peut fournir 
a la construction (nous verrons plus loin qu'il existe un lien entre ce nom d'action et la notion 
de chaine de commande) : 

AbstractAction actionl = new AbstractAction ("M0N_ACTI0N_1") ; 

Ne confondez pas la reference (actionl) a l'objet action avec son nom (MON_ACTION_l). 

Bien entendu, notre action comportera d'autres informations, notamment la couleur (type 
Color) correspondante. Nous serons done amenes a definir notre propre classe derivee de 
AbstractAction, par exemple : 

class MonAction extends AbstractAction 

public MonAction (String nom, Color couleur) 

{ super (nom) ; // appel du constructeur de AbstractAction 

this . couleur = couleur ; 

} 

private Color couleur ; 

} 

Nous creerons des objets de ce type, par exemple : 

Mon_Action actionRouge = new MonAction ("EN ROUGE", Color. red) ; 
Mon_Action actionjaune = new MonAction ("EN JAUNE", Color . yellow) ; 

8.1.2 Rattachement d'une action a un composant 

Certains composants, en particulier les menus (mais pas les boutons), disposent d'une 
methode add permettant de leur associer une action : 

JMenu menuCouleur = new JMenu ("COULEUR") ; 

menuCouleur. add (actionRouge) ; // ajoute 1' action actionRouge a menuCouleur 

Ici, Java cree automatiquement un objet de type JMenuItem, ayant pour libelle le nom de 
Taction correspondante (Rouge) et l'ajoute au menu menuCouleur. II n'est pas necessaire de 
creer un objet de type JMenuItem. 

8.1 .3 Gestion des evenements associes a une action 

La classe AbstractAction dispose deja d'une methode actionPerformed qu'on peut redefinir a 
volonte dans n'importe quelle classe derivee. Autrement dit, un objet action est obligatoire- 
ment un ecouteur des evenements Action, et cet ecouteur se trouve automatiquement associe 
au composant correspondant lors de l'execution de la methode add. 
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En definitive, notre classe action se presentera ainsi : 

class MonAction extends AbstractAction 

{ public MonAction (String nom, Color couleur) 

{ 

} 

public void actionPerformed (ActionEvent e) 

{ // reponse a toute action sur n' importe quel composant associe 
// a 1' ob jet action. 

// on peut identifier 1' action par e . getActionCommand 
} 

private Color couleur ; 

} 

8.1.4 Exemple complet 

Voici un exemple complet de programme associant de telles actions a des options de menus. 
Ici, nous nous limitons a un seul menu Couleur, forme de deux options Rouge et Vert. Nous 
tracons les evenements de type Action, en affichant la valeur de la chaine de commande 
(obtenue par getActionCommand). 



import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 



class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Emploi d' Actions ") ; setsize (300, 100) ; 

menu = new JMenuBarQ ; setJMenuBar (menu) ; 

menuCouleur = new JMenu ("COULEUR") ; 

actionRouge = new MonAction ("EN ROUGE", Color. red) ; 

actionjaune = new MonAction ("EN JAUNE", Color . yellow) 

menuCouleur . add ( actionRouge ) ; 

menuCouleur . add ( actionjaune ) ; 

menu. add (menuCouleur) ; 

} 

private MonAction actionRouge, actionjaune ; 

private JMenuBar menu ; 

private JMenu menuCouleur ; 

private JMenuItem optionRouge, option Jaune ; 

) 



class MonAction extends AbstractAction 
{ public MonAction (String nom, Color couleur) 
{ super (nom) ; 

this. couleur = couleur ; 

} 

public void actionPerformed (ActionEvent e) 
{ if (couleur == Color. red) 

System. out .println ("action rouge, chaine de commande : " 
+ e . getActionCommand ( ) ) ; 
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if (couleur == Color. yellow) 

System. out. println ("action jaune, chaine de commande : " 
+ e . getActionCommand ( ) ) ; 

} 

private Color couleur ; 

} 

public class Actionsl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . show ( ) ; 

} 

} 

action rouge, chaine de commande : EN ROUGE 
action jaune, chaine de commande : EN JAUNE 
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Premier exemple d' utilisation a" actions abstraites 

\^^~ Remarque 

La methode add permet d'ajouter une action a un menu en creant automatiquement 
l'option correspondante (de type JMemdtem). Parfois, on aura besoin de connaitre la 
reference a cette option. En fait, elle est tout simplement fournie par la methode add en 
valeur de retour. Par exemple, avec : 

JMenuItem option ; 

option = menuCouleur . add (actionRouge) ; 

la variable option contiendra la reference a l'option creee automatiquement par le ratta- 
chement de Taction actionRouge a menuCouleur. 

8.2 Association d'une meme action a plusieurs composants 

L' exemple precedent n'a guere d'interet en pratique puisqu'une action donnee n'est generee 
que par un seul composant. Mais il est facile de voir que la demarche s' applique au cas oil 
plusieurs composants sont susceptibles de generer la meme action. Nous allons illustrer cela 
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en completant le programme precedent en lui ajoutant un menu surgissant permettant lui- 
aussi de choisir une couleur. 

JPopupMenu menuSurg = new JPopupMenu ( ) ; 

menuSurg.add(actionRouge) ; // ajoute 1' action actionRouge au menu surgissant 
menuSurg. add (actionJaune) ; // ajoute 1' action actionjaune au menu surgissant 

Voici le programme complet ainsi modifie, en supposant que nous declencherons classique- 
ment le menu surgissant a la suite d'un clic droit : 



import javax. swing.* ; import java.awt.* ; import java.awt. event.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Emploi d' Actions ") ; setSize (300, 100) ; 

menu = new JMenuBar ( ) ; 

setJMenuBar (menu) ; 

menuCouleur = new JMenu ( "COULEUR" ) ; 

menu . add (menuCouleur ) ; 

actionRouge = new MonAction ("EN ROUGE", Color. red) ; 
actionjaune = new MonAction ("EN JAUNE", Color .yellow) ; 
menuCouleur. add (actionRouge) ; 
menuCouleur. add (actionjaune) ; 
menuSurg = new JPopupMenu ( ) ; 
menuSurg. add (actionRouge) ; 
menuSurg. add (actionjaune) ; 
addMouseListener (new MouseAdapter ( ) 

{ public void mouseReleased (MouseEvent e) 

{ menuSurg . show (e.getComponent () , e.getXQ, e.getYO) ; 

} 

} ) ; 

} 

private MonAction actionRouge, actionjaune ; 

private JMenuBar menu ; 

private JMenu menuCouleur ; 

private JMenuItem optionRouge, option Jaune ; 

private JPopupMenu menuSurg ; 

} 

class MonAction extends AbstractAction 

{ public MonAction (String nom, Color couleur) 

{ super (nom) ; this. couleur = couleur ; 

} 

public void actionPerformed (ActionEvent e) 
{ if (couleur == Color. red) 

System. out .println ("action rouge, chaine de commande : " 
+ e . getActionCommand ( ) ) ; 
if (couleur == Color . yellow) 

System. out. println ("action jaune, chaine de commande : " 
+ e . getActionCommand ( ) ) ; 

} 

private Color couleur ; 
) 
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public class Actions2 
{ public static void main (String 
{ MaFenetre fen = new MaFenetre ( 
fen . setvisible (true) ; 



args[ ] ) 



action rouge, 
action rouge, 
action jaune, 
action jaune. 



chaine de commande 



chaine de commande 



chaine de commande 



chaine de commande 



EN JAUNE 



EN ROUGE 



EN JAUNE 



EN ROUGE 



Second exemple d' utilisation d' actions abstraites 



8.3 Cas des boutons 



Dans les exemples precedents, nous avons pu utiliser la methode add de JPopupMenu ou de 
JMenu pour ajouter une action a un menu. Nous avons vu que cela creait automatiquement 
les options correspondantes. 

Mais il va de soi qu'on peut souhaiter associer une action a autre chose qu'une option, par 
exemple a un bouton, un bouton radio ou une case a cocher. Cela est possible mais moyen- 
nant certaines restrictions, comme nous allons le voir. 

Supposons que nous souhaitions completer l'exemple precedent en introduisant dans la fene- 
tre un bouton permettant de realiser Faction actionRouge. Cette fois, nous ne disposons plus 
de l'equivalent de la methode add(action) rencontree precedemment. II nous faut creer expli- 
citement le bouton. Cependant, nous allons souhaiter que son libelle soit le nom de Faction 
correspondante. Pour cela, nous utiliserons la methode getValue de la classe Abstract Action. 
Nous verrons plus loin que, outre le nom d' action, un objet de type AbstractAction comporte 
d'autres informations. La methode getValue fournit en fait la valeur d'une information dont 
on lui precise la nature. Ainsi, avec : 

actionRouge . getValue (Action. NAME) 
nous obtiendrons la valeur de Finformation de nature Action.NAME ; la nature de F informa- 
tion recherchee est definie par une constante de type chaine (ici NAME) de la classe Action. 
Comme le resultat fourni par getValue est de type Object, il nous faudra prevoir une conver- 
sion en String. 

Finalement, voici comment creer un bouton ay ant comme libelle le nom de Faction 
actionRouge : 

JButton boutonRouge = new JButton ( (String) actionRouge. getValue (Action.NAME) ) ; 

Nous devons ensuite faire de F objet actionRouge un ecouteur d'evenement Act ion de notre 
bouton : 

boutonRouge. addActionListener (actionRouge) ; 
Bien sur, il faudra egalement ajouter le bouton a la fenetre. 
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Ainsi, vous voyez que nous pouvons quand meme beneficier du mecanisme des actions abs- 
traites pour notre bouton. Simplement, il nous aura fallu prevoir explicitement : 

• 1' attribution du nom d' action comme libelle du bouton, 

• Fassociation de Taction comme ecouteur du bouton. 

Ces operations etaient realisees automatiquement pour les menus par la methode add. 

En definitive, nous pouvons facilement adapter l'exemple du paragraphe 8.1, de facon que la 
couleur rouge puisse etre choisie indifferemment depuis le menu Couleur (comportant les 
options Rouge et Vert) ou depuis un bouton (place ici en bas de la fenetre) 1 . II nous suffit en 
effet d'ajouter les instructions suivantes dans le constructeur de MaFenetre : 

boutonRouge = new JButton ( (String) actionRouge . getValue (Action. NAME) ) ; 
getContentPane ( ) . add (boutonRouge, "South") ; 
boutonRouge. addActionListener (actionRouge) ; 

private JButton boutonRouge ; 

Voici le programme ainsi obtenu : 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Emploi d' Actions ") ; setSize (300, 100) ; 

menu = new JMenuBar ( ) ; 

setJMenuBar (menu) ; 

menuCouleur = new JMenu ( "COULEUR" ) ; 

menu . add (menuCouleur ) ; 

actionRouge = new MonAction ("EN ROUGE", Color. red) ; 
actionjaune = new MonAction ("EN JAUNE", Color .yellow) ; 
menuCouleur. add (actionRouge) ; 
menuCouleur . add ( actionjaune ) ; 

boutonRouge = new JButton ( (String) actionRouge. getValue (Action. NAME) ) ; 
getContentPane (). add (boutonRouge, "South") ; 
boutonRouge. addActionListener (actionRouge) ; 

} 

private MonAction actionRouge, actionjaune ; 

private JMenuBar menu ; 

private JMenu menuCouleur ; 

private JMenuItem optionRouge, option Jaune ; 

private JButton boutonRouge ; 

} 



1 . Par souci de simplicite, nous nous limitons a un bouton. En pratique, on sera amene a prevoir un bouton pour 
chacune des deux actions. 
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class MonAction extends AbstractAction 
{ public MonAction (String nom, Color couleur) 
{ super (nom) ; 

this. couleur = couleur ; 

} 

public void actionPer formed (ActionEvent e) 
{ if (couleur == Color. red) 

System . out . println ("action rouge, chaine de commande : " 
+ e . getActionCommand ( ) ) ; 

if (couleur == Color. yellow) 

System. out. println ("action jaune, chaine de commande : " 
+ e . getActionCommand ( ) ) ; 

} 

private Color couleur ; 

} 

public class Actions3 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 

action rouge, chaine de commande : EN ROUGE 
action rouge, chaine de commande : EN ROUGE 
action jaune, chaine de commande : EN JAUNE 



I^Emploi d'Actions 
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Utilisation d'actions abstraites avec un menu et un bouton 

8.4 Autres possibilites de la classe AbstractAction 
8.4.1 Informations associees a la classe AbstractAction 

Nous avons vu qu'un objet de la classe AbstractAction encapsulait une information corres- 
pondant a son nom qu'on pouvait obtenir par getValue (Action.NAME) (rappelons que la 



Les menus, les actions et les barres d'outils 

Chapitre 15 



valeur de retour etait de type Object et qu'elle necessitait une conversion en String). D'une 
maniere generale, cette classe encapsule les informations suivantes : 



Constante 


Information associee 


Action. NAME 

Action.SMALLJCON 

Action.SHORT DESCRIPTIO 
N 

Action. LONG_DESCRIPTION 


Nom de I'action (utilisee automatiquement par add pour 
les menus et les barres d'outils) 

Icone susceptible d'etre associee a I'action 

Breve description de I'action (utilisable dans les bulles 
d'aide) 

Description detaillee de I'action (utilisable dans des fene- 
tres d'aide) 



Les informations associees a la classe AbstractAction 



Nous avons deja vu que 1' information NAME pouvait etre fournie lors de la construction 
(bien que ce ne soit pas obligatoire). Les autres informations ont, par defaut, la valeur null. 
On peut leur attribuer une valeur a tout instant a l'aide de la methode putValue, par exemple : 

actionRouge.putValue (Action. SHORT_DESCRIPTION, "fond de couleur rouge") ; 

II faut cependant noter que seuls le nom d' action et F icone peuvent etre utilises automatique- 
ment par la methode add (et encore cette particularite est-elle limitee aux menus et aux barres 
d'outils). Si Ton souhaite, par exemple, faire apparaitre la breve description dans une bulle 
d'aide, il faudra le programmer explicitement (avec getValue et setToolTipText), comme nous 
l'avons fait pour le nom d'action avec des boutons (voir au paragraphe 8.3). Nous en verrons 
un exemple dans le programme recapitulatif de fin de chapitre. 

8.4.2 Activation/desactivation d'options 

Nous avons deja signale qu'il etait possible d'activer ou de desactiver un composant quelcon- 
que en utilisant la methode setEnabled. Cette methode peut aussi s'appliquer a une action. 
Dans ce cas, il est interessant de noter que Fetat d'activation de Taction sera automatique- 
ment repercute sur les options qu'on aura creees automatiquement (par add) a partir de 
Taction concernee (il en ira de meme pour les boutons associes a une barre d'outils). 

En revanche, rien de tel n'aura lieu pour les autres composants. Si, par exemple, on a associe 
un bouton boutonRouge a une action actionRouge (comme on Ta fait au paragraphe 8.3), il 
faudra pre voir explicitement T activation ou la deactivation du bouton en meme temps que 
celle de Taction. Nous en verrons un exemple dans le programme recapitulatif de fin de cha- 
pitre. 



9 Les barres d'outils 

De nombreuses applications du commerce disposent de barres d'outils. II s'agit d'ensembles 
de boutons regroupes lineairement sur un des bords de la fenetre. En general, ces boutons 
comportent des icones plutot que des libelles. Parfois, ces barres sontflottantes, ce qui signi- 
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fie qu'on peut les deplacer d'un bord a un autre de la fenetre, ou a l'interieur (la barre se 
transforme alors en une petite fenetre qu'on peut retailler, voire reduire en icone). 

Java vous permet de realiser facilement de telles barres d'outils. Nous verrons tout d'abord 
comment les remplir avec des boutons (JButton). Mais nous verrons ensuite que, a l'image 
des menus, on peut aussi les remplir avec des actions. 

9.1 Generates 

On cree un objet barre d'outils a l'aide du constructeur de la classe JToolBar : 

JToolBar barreCouleurs = new JToolBar () ; 

On peut y introduire des boutons par la methode add : 

JButton boutonRouge = new JButton ("Rouge") ; 
barreCouleurs . add (boutonRouge ) ; 
JButton boutonVert = new JButton ("Vert") ; 
barreCouleurs . add (boutonVert ) ; 

La barre est ajoutee a une fenetre fen en l'ajoutant par add a son contenu : 

fen . getContentPane ( ) . add (barreCouleurs ) ; 

La gestion des boutons d'une barre d'outils est identique a celles des boutons : on associe un 
ecouteur a chacun de ses boutons. 

Voici un exemple de programme qui cree une barre d'outils formee de deux boutons et qui se 
contente d'afficher un message lors de Faction sur chacun d'entre eux : 

import j ava . awt . * ; 
import j ava. awt. event.* ; 
import javax. swing.* ; 
import javax. swing. event.* ; 

class FenOutil extends JFrame implements ActionListener 
{ public FenOutil () 

{ setTitle ("Barre tf outils") ; 
setSize (300, 100) ; 

Container contenu = getContentPane ( ) ; 

/* creation barre d outils couleurs * / 
barreOutils = new JToolBar () ; 
boutonRouge = new JButton ("Rouge") ; 
barreOutils. add (boutonRouge) ; 
boutonVert = new JButton ("Vert") ; 
barreOutils. add (boutonVert) ; 
contenu. add (barreOutils, "North") ; 

} 

public void actionPer formed (ActionEvent e) 

{ if (e.getSource () == boutonRouge) System. out. println ("action rouge") ; 
if (e.getSource () == boutonVert) System. out. println ("action vert") ; 

} 

private JToolBar barreOutils ; 

private JButton boutonRouge, boutonVert ; 

} 
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public class Outill 

{ public static void main (String args[ ] ) 
{ FenOutil fen = new FenOutilO ; 
fen . setvisible (true) ; 

} 

} 

action rouge 
action vert 
action vert 






Creation et exploitation d'une barre d'outils 

9.2 Barres d'outils flottantes ou integrees 

Par defaut, une barre d'outils est flottante, ce qui signifie que Futilisateur peut la deplacer 
dans la fenetre. Ainsi, dans notre precedent programme, il peut Famener sur Fun des bords en 
utilisant sa poignee et obtenir ceci (ici, la barre est sur le bord droit) : 



I^Barre d'outils 


- °|*| 




Roui_ 
Vert 


e 



II peut aussi l'amener a l'interieur de la fenetre (et non plus sur un des bords). La barre se 
transforme alors en une petite fenetre dotee des cases habituelles : 



m 


- n|x| 




Rouge | Vert | 



L'utilisateur peut alors la reduire en icone ou meme la fermer. Dans ce cas, le programme 
devra disposer d'un moyen de la faire reapparaitre (setVisible(true)). 

On peut interdire a une barre d'outils de Hotter en utilisant ainsi la methode setFloatable : 

barresOutils . setFloatable (false) ; 
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9.3 Utilisation d'icones dans les barres d'outils 

Nous savons deja qu'un bouton (JButton) peut etre cree avec une icone au lieu d'un texte. Par 
exemple, si nous disposons d'un fichier nomme rouge.gif et contenant un dessin d'un carre de 
couleur rouge, nous pouvons creer un objet icone de cette facon : 

Imagelcon iconeRouge = new Imagelcon ( "rouge.gif ") ) ; // creation d une icone 

// avec le contenu du fichier de nom rouge.gif 

Si nous disposons egalement d'un fichier vert.gif contenant le dessin d'un carre vert, voici 
comment nous pourrions construire notre barre d'outils avec deux boutons contenant unique - 
ment les icones de couleur : 

barreOutils = new JToolBar () ; 

boutonRouge = new JButton (new Imagelcon ("rouge.gif") ) ; 
barreOutils . add (boutonRouge) ; 

boutonVert = new JButton (new Imagelcon ("vert.gif")) ; 
barreOutils . add (boutonVert) ; 
contenu. add (barreOutils, "North") ; 

L' adaptation dans ce sens du programme precedent figure sur le site Web d' accompagnement 
sous le nom OutiU.java. Voici ce que produit son execution : 



> 




Remarque 

La demarche d'association d'une bulle d'aide a une option de menu peut aussi s'appli- 
quer a un bouton d'une barre d'outils. 



9.4 Association d'actions a une barre d'outils 

Nous avons deja vu comment l'ajout d'une action a un menu introduit automatiquement les 
options correspondantes. Cette propriete se generalise aux barres d'outils. II suffit en effet 
d'ajouter une action a une barre pour que cela provoque : 

• la creation du bouton, avec comme libelle le nom de Taction, 

• son ajout a la barre, 

• F association de Faction comme ecouteur du bouton. 
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Mais on preferera generalement qu'une barre d'outils presente des icones plutot que des 
libelles. Pour y parvenir, on disposera de deux demarches. 

• Creer une action sans nom en fournissant la reference null a son constructeur, puis luis as- 
socier une icone, par exemple : 

actionRouge.putValue (Action. SMALL_I CON, "rouge.gif") ; 

L'ajout de Taction a la barre fera alors apparaitre l'icone correspondante. 

• Creer Taction avec a la fois un nom (fourni au constructeur) et une icone (installee par 
setValue (Action. SMALL_ICON, ...)), puis ajouter cette action a la barre d'outils et suppri- 
mer le libelle du bouton (dont on obtient la reference en retour de add) par setText(null). 

Vous trouverez un exemple d' application de cette deuxieme demarche dans Texemple 
d' application suivant. 



10 Exemple d'application 

Voici une nouvelle adaptation de Texemple d'application propose a la fin des deux chapitres 
precedents. II s'agit toujours de choisir des formes, des dimensions et des couleurs. Les for- 
mes et les dimensions sont choisies par un menu usuel. En revanche, les couleurs peuvent 
etre choisies de trois facons differentes : 

• par un menu usuel Couleur, comportant les noms des couleurs, 

• par un menu surgissant comportant a la fois les noms des couleurs et des icones constitutes 
d'un carre de la couleur correspondante, 

• par une barre d'outils ne comportant que les icones de couleur. 

Les icones necessaires sont fournies dans meme repertoire que le programme, sous la forme 
de fichiers de nom rouge.gif, vert.gif, jaune.gif 'et bleu.gif. 

Les actions ont ete crees avec un nom, une icone et un texte explicatif 
{SHORT _DESCRIPTION). Apres ajout d'une action a la barre d'outils, on supprime le texte 
du bouton cree automatiquement en appliquant Tappel setText(null) a la reference fournie en 
retour de add. 

On associe le texte explicatif des actions aux bulles d'aide correspondantes de la barre 
d'outils. Cette operation n'est pas automatique et elle doit done etre programmed explicite- 
ment (getValue pour Taction, setToolTipText pour le bouton correspondant). 

Chaque fois qu'une couleur est selectionnee, Taction correspondante est desactivee, ce qui se 
repercute sur les menus, les menus surgissants et les boutons de la barre d'outils. 

Ici encore, Texemple d'execution a ete obtenu en laissant allume le menu surgissant et en 
deplacant la souris vers la barre d'outils pour faire apparaitre une bulle d'aide. 
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import java.awt.*; import j ava . awt . event . * ; 
import javax. swing.* ; import javax. swing. event.* ; 
class FenMenu extends JFrame implements ActionListener 
{ static public final String} ] nomCouleurs = 

{ "rouge", "vert", "jaune", "bleu"} ; 

static public final Color[ ] couleurs = 

{Color. red, Color. green, Color. yellow, Color. blue} ; 
static public final String} ] nomlcones = 

{ "rouge.gif", "vert.gif", "jaune.gif", "bleu.gif"} ; 

public FenMenu () 

{ setTitle ("Figures avec Menus et barre d outils") ; setSize (450, 200) ; 
Container contenu = getContentPane ( ) ; 

/* creation paneau pour les dessins * / 
pan = new Paneau ( ) ; 
contenu. add (pan) ; 
pan. setBackground (Color. cyan) ; 
int nbCouleurs = nomCouleurs . length ; 

/* creation des actions * / 
actions = new ActionCouleur [ nbCouleurs] ; 
for (int i=0 ; KnbCouleurs ; i++) 

{ actions} i] = new ActionCouleur (nomCouleurs[ i] , couleurs} i] , 

nomlcones} i] , pan) ; 

} 

/* creation barre des menus * / 
barreMenus = new JMenuBarO ; setJMenuBar (barreMenus) ; 

/* creation menu Couleur et ses options * / 
couleur = new JMenu ( "Couleur" ) ; couleur . setMnemonic (' C ) ; 
barreMenus . add (couleur ) ; 
for (int i=0 ; i< nomCouleurs . length ; i++) 
couleur. add (actions} i] ) ; 

/* creation menu surgissant Couleur et ses options * / 
couleurSurg = new JPopupMenu () ; 
for (int i=0 ; i< nomCouleurs . length ; i++) 
couleurSurg. add (actions} i] ) ; 

/* creation menu formes et ses options rectangle et ovale * / 
formes = new JMenu ("Formes") ; formes . setMnemonic (' F ) ; 
barreMenus. add (formes) ; 

rectangle = new JCheckBoxMenuItem ("Rectangle") ; 

formes. add (rectangle) ; 

rectangle . addActionListener (this) ; 

ovale = new JCheckBoxMenuItem ("Ovale") ; 

formes. add (ovale) ; 

ovale . addActionListener (this) ; 

/* af f ichage menu surgissant sur clic dans fenetre * / 
addMouseListener (new MouseAdapter () 

{ public void mouseReleased (MouseEvent e) 
{ if (e.isPopupTrigger () ) 

couleurSurg . show ( e . getComponent ( ) , e . getx ( ) , e . getY ( ) ) ; 

} 

} ) ; 
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/* creation menu Dimensions et ses options Hauteur et Largeur * / 
dimensions = new JMenu ("Dimensions") ; dimensions . setMnemonic (' D* ) ; 
barreMenus . add (dimensions ) ; 
largeur = new JMenuItem ("Largeur") ; 
dimensions . add (largeur) ; 
largeur .addActionListener (this) ; 
hauteur = new JMenuItem ("Hauteur") ; 
dimensions . add (hauteur) ; 
hauteur . addActionListener (this) ; 

/* creation barre d' outils couleurs * / 

/* (avec suppression textes associes et ajout de bulles d' aide */ 
barreCouleurs = new JToolBar () ; 
for (int i=0 ; KnomCouleurs . length ; i++) 
{ JButton boutonCourant = barreCouleurs . add (actions! i] ) ; 

boutonCourant . setText (null ) ; 

boutonCourant . setToolTipText 

( (String) actions! i] . getValue (Action . SHORT_DESCRIPTION) ) ; 

} 

contenu . add (barreCouleurs , "North" ) ; 

} 

public void actionPerformed (ActionEvent e) 
{ Object source = e . getSource ( ) ; 
if (source == largeur) 

{ String ch = JOptionPane . showInputDialog (this, "Largeur") ; 
pan . setLargeur (Integer .parselnt (ch) ) ; 

} 

if (source == hauteur) 

{ String ch = JOptionPane . showInputDialog (this, "Hauteur") ; 
pan . setHauteur (Integer .parselnt (ch) ) ; 

} 

if (source == ovale) pan. setOvale (ovale. isSelectedO ) ; 

if (source == rectangle) pan. setRectangle (rectangle. isSelectedO ) ; 

pan . repaint ( ) ; 

} 

private JMenuBar barreMenus ; 
private JMenu couleur, dimensions, formes ; 
private JMenuItem [ ] itemCouleurs ; 
private JMenuItem largeur, hauteur ; 
private JCheckBoxMenuItem rectangle, ovale ; 
private JPopupMenu couleurSurg ; 
private ActionCouleur [ ] actions ; 
private JToolBar barreCouleurs ; 
private Paneau pan ; 

} 

class Paneau extends JPanel 
( public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

if (ovale) g.drawOval (10, 10, 10+largeur, 10+hauteur) ; 

if (rectangle) g.drawRect (10, 10, 10+largeur, 10+hauteur) ; 

} 
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public void setRectangle (boolean trace) { rectangle = trace ; } 

public void setOvale (boolean trace) { ovale = trace ; } 

public void setLargeur (int 1) { largeur = 1 ; } 

public void setHauteur (int h) { hauteur = h ; } 

public void setCouleur (Color c) { setBackground (c) ; } 

private boolean rectangle = false, ovale = false ; 

private int largeur=50, hauteur=50 ; 



class ActionCouleur extends AbstractAction 

{ public ActionCouleur (String nom, Color couleur, String nomlcone, Paneau pan) 
{ putValue (Action. NAME, nom) ; 

putValue (Action . SMALL_I CON, new Imagelcon (nomlcone) ) ; 
putValue (Action. SHORTJDESCRIPTION, "Fond "+nom) ; 
this . couleur = couleur ; 
this. pan = pan ; 

} 

public void actionPer formed (ActionEvent e) 
{ pan . setCouleur (couleur) ; 

pan . repaint ( ) ; 

setEnabled (false ) ; 

if (actionlnactive != null) actionlnactive . setEnabled (true) ; 
actionlnactive = this ; 

} 

private Color couleur ; 
private Paneau pan ; 

static ActionCouleur actionlnactive ; // ne pas oublier static 

} 

public class ExMenuAc 

{ public static void main (String args[ ] ) 
{ FenMenu fen = new FenMenu ( ) ; 
fen . setvisible (true) ; 

} 
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Les evenements de bas niveau 



Java distingue deux sortes d' evenements : les evenements de bas niveau et les evenements 
semantiques. Les premiers correspondent a des actions physiques de l'utilisateur sur le cla- 
vier ou la souris ; c'est par exemple le cas d'un clic dans une fenetre. Les seconds sont des 
evenements plus elabores qui, bien que toujours generes suite a une action physique de l'uti- 
lisateur, ont ete "interpretes" par l'environnement et par Java, afin de leur attribuer une signi- 
fication. C'est par exemple le cas de Faction sur un bouton, qui peut trouver son origine dans 
un clic a la souris ou dans une frappe au clavier. II en va de meme pour la saisie dans un 
champ de texte, qui resulte en fait d'une succession d' evenements de bas niveau (frappes de 
touches, clics eventuels...). 

En toute rigueur, la distinction entre ces deux sortes d' evenements comporte une part d'arbi- 
traire, dans la mesure ou meme un evenement de bas niveau comme un clic necessite une part 
d' interpretation, pour fournir les coordonnees (relatives) du clic a Finteneur du composant 
concerne. De plus, Java classe dans les evenements de bas niveau des evenements lies a la 
gestion des fenetres ou a ce qu'on nomme la focalisation. 

Dans les chapitres precedents, nous avons etudie la plupart des evenements semantiques. En 
revanche, en ce qui concerne les evenements de bas niveau, nous nous sommes limites au 
simple clic sur un des boutons de la souris. Ce chapitre fait le point sur Fensemble des evene- 
ments de bas niveau, a savoir : 

• les evenements lies a la souris : distinction entre appui et relachement des boutons, identifi- 
cation des boutons, double clic, operations de glisser... 

• les evenements lies au clavier : distinction entre appui et relachement d'une touche, distinc- 
tion entre touche et caractere (notion de code de touche virtuelle), 
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• les evenements de focalisation, 



• les evenements de gestion des fenetres. 



1 



Les evenements lies a la souris 



La plupart du temps, nous nous sommes contentes d'exploiter l'evenement clic (complet) 
gere par la methode mouseClicked. En fait, les actions sur la souris generent d'autres evene- 
ments que nous allons examiner progressivement. Nous considererons tout d'abord les eve- 
nements les plus simples correspondant a l'appui et/ou au relachement d'un bouton. Nous 
verrons ensuite comment identifier le bouton concerne et comment gerer les doubles clics. 
Puis nous etudierons les differents evenements lies au deplacement de la souris, ce qui nous 
permettra de vous montrer comment mettre en ceuvre les operations dites de "glisser". 



1 .1 Gestion de l'appui et du relachement des boutons 



Java genere un evenement a chaque appui (mousePressed) sur un bouton et a chaque relache- 
ment (mouseReleased). De plus, a partir de la succession de ces deux evenements (appui et 
relachement d'un bouton), il generera un evenement "clic complet" (mouseClicked), a condi- 
tion que la souris n'ait pas ete deplacee entre temps. 

Nous avons deja vu que ces trois methodes mousePressed, mouseReleased et mouseClicked 
appartiennent a l'interface MouseListener (qui comporte egalement deux autres methodes 
mouseEntered et mouseExited dont nous parlerons un peu plus loin). 

Voici un exemple de programme qui se contente de "tracer" ces trois evenements en affichant 
en fenetre console un message precisant les coordonnees de la souris (rappelons qu'on les 
obtient avec les methodes getX() et getY() de la classe MouseEvent). L' exemple d'execution 
comporte des commentaires mentionnant les actions de Futilisateur. 

import javax. swing.* ; 

import java.awt.* ; import java.awt. event.* ; 

class MaFenetre extends JFrame implements MouseListener 

{ public MaFenetre () 

{ setTitle ("Traces souris") ; 

setSize (300, 180) ; 

addMouseListener (this) ; 

} 

public void mouseClicked (MouseEvent e) 

{ System. out. println ("mouseClicked en " + e.getXO + " " + e.getYO) ; 

} 

public void mousePressed (MouseEvent e) 

{ System. out. println ("mousePressed en " + e.getXO + " " + e.getYO) ; 

} 

public void mouseReleased (MouseEvent e) 

{ System. out. println ("mouseReleased en " + e.getXO + " " + e.getYO ) ; 

} 
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public void mouseEntered (MouseEvent e) { } 
public void mouseExited (MouseEvent e) { } 

} 

public class Sourisl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 



mousePressed en 72 89 // 

mouseReleased en 72 89 // 
mouseClicked en 72 89 

mousePressed en 50 61 // 

mouseReleased en 243 111 // 

mousePressed en 74 66 // 

mouseReleased en -173 137 // 



appui bouton gauche 
relachement bouton gauche 

appui bouton gauche, puis deplacement 
relachement bouton gauche 
appui bouton gauche, puis deplacement 
hors fenetre et relachement 



Exemple de gestion des pressions et reldchements de la souris 



> 



Remarques 

1 On constate bien qu'un evenement mouseClicked n'est genere que si la souris n'a pas ete 
deplacee entre 1' appui et le relachement du bouton. 

2 Si Ton appuie sur un bouton alors que la souris est dans la fenetre et qu'on la fait glisser 
en dehors (c'est-a-dire en gardant le bouton enfonce), on obtiendra quand meme un eve- 
nement mouseReleased au moment du relachement ; c'est ce qui justifie Fabscisse nega- 
tive dans l'exemple. 

3 Ici, nous ne distinguons pas le bouton concerne. Pour fixer les idees, nous avions sup- 
pose qu'il s'agissait du gauche, mais on obtiendrait exactement la meme chose avec le 
bouton droit (ou le bouton central s'il existe). On peut meme realiser des operations 
"mixtes", comme le montre cet autre exemple d'execution du meme programme : 

mousePressed en 89 91 // appui bouton gauche qu' on garde enfonce 
mousePressed en 211 108 // deplacement et clic bouton droit (gauche appuye) 
mouseReleased en 211 108 // relachement bouton gauche 
mouseClicked en 211 108 // 

mouseReleased en 85 112 // relachement bouton droit 

Ainsi, on a fait apparaitre un clic en 21 1, 108, alors qu'il ne s'agit que la succession des 
evenements : appui droit en ce point, liberation gauche en ce meme point. 

Nous verrons plus loin qu'il est possible de connaitre le bouton associe a un evenement. 
Cependant, pour pouvoir eliminer le faux clic precedent, il faudrait reconstituer 1' eve- 
nement clic en gerant soi-meme la succession des appuis et relachements, ce que Ton 
fera rarement en pratique. 
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1 .2 Identification du bouton et dies multiples 

II est possible de connaitre le(s) bouton(s) de la souris concerne(s) par un evenement donne, 
en recourant a la methode getModifiers de la classe MouseEvent. Elle fournit un entier dans 
lequel un bit de rang donne est associe a chacun des boutons et prend la valeur 1 pour indi- 
quer un appui. La classe InputEvent contient des constantes qu'on peut utiliser comme "mas- 
ques" afin de tester la presence d'un bouton donne dans la valeur de getModifiers : 



Masque 


Bouton correspondant 


lnputEvent.BUTT0N1_MASK 
lnputEvent.BUTT0N2_MASK 
lnputEvent.BUTT0N3_MASK 


gauche 

central (s'il existe) 
droite 



Par exemple, pour savoir si le bouton droit est enfonce, on procedera ainsi : 

if ( (e. getModifiers () s InputEvent . BOTTON3_MASK) != 0) ... 

Lorsqu'on s'interesse uniquement au relachement du bouton droit, notamment pour declen- 
cher Faffichage d'un menu surgissant, on peut se contenter d'utiliser la methode isPopup- 
Trigger 1 comme nous l'avons fait au paragraphe 3 du chapitre 15. 

Quant aux doubles clics, on peut les gerer avec la methode getClickCount (de la classe 
MouseEvent) qui fournit un compteur de clics successifs en un meme point. Ce compteur est 
remis a zero : 

• soit lorsque vous deplacez la souris, 

• soit lorsqu'un certain temps s'est ecoule apres un clic ; ce delai est generalement parame- 
trable par Tenvironnement. 

Voici un exemple dans lequel nous tracons les memes evenements que precedemment, mais 
en affichant les informations fournies par getModifiers, isPopupTrigger et getClickCount. 
Notez que, pour simplifier l'ecriture du code, nous avons prevu une methode de service (sta- 
tique) nommee details, chargee d'afficher ces differentes informations pour un evenement 
donne (fourni en argument). La encore, les actions realisees lors de l'execution sont indi- 
quees par des commentaires accompagnant les resultats fournis en fenetre console. 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class MaFenetre extends JTrame implements MouseListener 
{ public MaFenetre () 

{ setTitle ("Traces souris") ; setSize (300, 180) ; 
addMouseListener (this) ; 

} 



1. Attention a bien faire le test dans mouseReleased et non dans mouseClicked. 
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public void mouseClicked (MouseEvent e) 
{ details ("mouseClicked ", e) ; } 
public void mousePressed (MouseEvent e) 
{ details ("mousePressed ", e) ; 
} 

public void mouseReleased (MouseEvent e) 

{ details ("mouseReleased ", e) ; 

} 

public void mouseEntered (MouseEvent e) { } 

public void mouseExited (MouseEvent e) { } 

public static void details (String txt, MouseEvent e) 

{ System. out. print (txt + e.getXQ + " " + e.getYO) ; 

System . out .print ( " Ctr = " + e . getClickCount ( ) ) ; 

System. out. print (" Boutons : ") ; 

if ( (e.getModifiers () & InputEvent . BUTTONl_MASK) != 0) 

System. out. print ("gauche ") ; 
if ( (e.getModifiers () S InputEvent . BUTTON2_MASK) != 0) 

System. out. print ("milieu ") ; 
if ( (e.getModifiers () S InputEvent . BUTTON3_MASK) != 0) 

System . out . print ("droite ") ; 
if (e.isPopupTrigger () ) System. out. print (" Popup ") ; 
System. out. println () ; 

} 

} 

public class Souris2 

{ public static void main (String args[ ] ) 

{ MaFenetre fen = new MaFenetreO ; fen. setvisible (true) ; 
} 
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Exemple d' exploitation des informations fournies par I'objet MouseEvent 
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Remarques 

1 Java ne dispose que d'un seul compteur de clics pour les deux (ou trois) boutons. Cela 
signifie qu'on peut provoquer un double clic en cliquant successivement sur deux boutons 
differents. Si Ton veut absolument eviter ce phenomene, il faut effectuer un suivi plus fin 
des actions de l'utilisateur, en s'assurant que le premier et le second clic concernent bien 
le meme bouton. 

2 On peut facilement faire aller le compteur de clics au-dela de 2. En general, on 
n'exploite pas cette possibility, pour d'evidentes raisons de confort de l'utilisateur. 




Informations complementaires 



Dans la classe MouseEvent, on dispose de quelques methodes permettant de connaitre 
l'etat des touches Cntrl, Shift etAlt du clavier au moment de l'evenement souris concerne. 
II s'agit de isControlDown, isShiftDown et isAltDown qui fournissent la valeur true si la 
touche correspondante est pressee ; la methode isMetaDown fournit la valeur true si l'une 
(au moins) de ces trois touches est pressee. 

1 .3 Gestion des emplacements de la souris 

Des que vous deplacez la souris, meme sans cliquer sur un de ses boutons, vous provoquez 
des evenements. Tout se passe comme si, a des intervalles de temps relativement reguliers, la 
souris signalait sa position, ce qui peut donner naissance a deux sortes d'evenements : 

• entree-sortie de composant. Java genere : 

- un evenement mouseEntered chaque fois que la souris passe de l'exterieur a Pinterieur 
d'un composant, 

- un evenement mouseExited chaque fois que la souris passe de l'interieur a l'exterieur 
d'un composant ; 

• displacement sur un composant. Lorsque la souris est deplacee sur un composant donne, il 
y a: 

- generation d'evenements mouseMoved si aucun bouton n'est enfonce, 

- generation d'evenements mouseDragged si un bouton est reste enfonce pendant le de- 
placement. 

Notez bien que les evenements mouseDragged continuent d'etre generes (pour le compo- 
sant concerne) meme si la souris sort du composant, et ce jusqu'a ce que l'utilisateur relache 
le bouton. 
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Les deux methodes mouseMoved et mouseDragged appartiennent a une interface Mouse- 
MotionListener (et non pas, comme les precedentes, a MouseListener) ; toutefois, le type 
des evenements reste MouseEvent 1 . II existe une classe adaptateur MouseMotionAdapter . 

Voici une adaptation du programme precedent mettant en evidence ces evenements de depla- 
cement (en plus des autres). 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class MaFenetre extends JFrame implements MouseListener, MouseMotionListener 
{ public MaFenetre () 

{ setTitle ("Traces souris") ; setSize (300, 180) ; 

addMouseListener (this) ; 

addMouseMotionListener (this) ; 

} 

public void mouseClicked (MouseEvent e) 
{ details ("mouseClicked ", e) ; } 
public void mousePressed (MouseEvent e) 
{ details ("mousePressed ", e) ; } 
public void mouseReleased (MouseEvent e) 
{ details ("mouseReleased ", e) ; } 
public void mouseEntered (MouseEvent e) 
{ details ("mouseEntered ", e) ; } 
public void mouseExited (MouseEvent e) 
{ details ("mouseExited ", e) ; } 
public void mouseMoved (MouseEvent e) 
{ details ("mouseMoved ", e) ; } 
public void mouseDragged (MouseEvent e) 
{ details ("mouseDragged ", e) ; } 

public static void details (String txt, MouseEvent e) 
{ System. out. print (txt + e.getXQ + " " + e.getY(J) ; 

System . out .print ( " Ctr = " + e . getClickCount ( ) ) ; 

System. out. print (" Boutons : ") ; 

if ( (e . getModif iers () S InputEvent . BUTTONl_MASK) != 0) 

System . out . print ("gauche ") ; 
if ( (e. getModif iers () & InputEvent . BUTTON2_MASK) != 0) 

System . out . print ("milieu ") ; 
if ( (e. getModif iers () & InputEvent. BUTTON3_MASK) != 0) 

System . out . print ("droite ") ; 
if (e.isPopupTrigger () ) System. out. print (" Popup ") ; 
System. out. println () ; 

} 

} 



1. On voit qu'une certaine ambiguite de vocabulaire risque d'apparaitre. Les objets evenements sont toujours 
du type MouseEvent, de sorte qu'on pourrait parler d'evenements de la categorie Mouse. Mais le fait qu'il existe 
deux interfaces pour les ecouteurs (MouseListener et MouseMotionListener) pourrait nous amener a distinguer 
deux categories d'evenements : Mouse et MouseMotion. 



Les evenements de bas niveau 

Chapitre 16 



public class Souris3 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 
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Gestion des evenements de deplacement de la souris 



1 .4 Exemple de selection de zone 

Dans certaines applications, il est necessaire de permettre a Futilisateur d'effectuer un "glis- 
ser" de la souris. On nomme ainsi un appui sur un bouton de la souris suivi d'un deplacement 
de la souris et enfin d'un relachement. Une telle operation permet de definir deux points 
d'une fenetre qui peuvent servir par exemple a : 

• deplacer un element d'un point a un autre, 

• definir une zone rectangulaire dans laquelle on viendra dessiner une figure geometrique, 

• delimiter une partie d'une image en vue de la transformer ou de la copier. 

L' existence des evenements mouseDragged facilite grandement la programmation d'une telle 
selection. C'est ce que montre l'exemple suivant, dans lequel nous representons par un rec- 
tangle la zone ainsi selectionnee par Futilisateur, chaque nouvelle selection effacant 
l'ancienne. II suffit en effet d'exploiter les evenements mouseDragged et mouseReleased en 
memorisant les coordonnees du premier evenement mouseDragged. Une variable booleenne 
enCours, placee initialement a false, est placee a true au premier de ces evenements. Elle est 
remise a false au premier evenement mouseReleased suivant. 
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Ici, nous employons un adaptateur MouseAdapter pour l'evenement mouseReleased (ce qui 
evite d' avoir a fournir le corps vide des quatre autres methodes). En revanche, nous imple- 
mentons l'interface MouseMotionListener en fournissant une methode mouseMoved vide. 

Notez que nous avons tenu compte de la possibilite pour l'utilisateur de selectionner la zone 
dans n'importe quel sens. C'est ce qui justifie la determination de la plus grande des deux 
abscisses de debut et de fin, ainsi que de la plus grande des deux ordonnees 1 . 



import java.awt.* ; import java.awt. event.* ; import j avax . swing . * ; 
import j avax. swing. event.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Essais drag souris") ; setSize (300, 200) ; 

paneau = new Paneau ( ) ; 

getContentPane ( ) . add (paneau) ; 

} 

private JPanel paneau ; 

} 

class Paneau extends JPanel implements MouseMotionListener 
{ Paneau ( ) 

{ addMouseMotionListener (this) ; 

addMouseListener (new MouseAdapter ( ) 

{ public void mouseReleased (MouseEvent e) 
{ enCours = false ; 

System . out . println ("Release "te.getXQ + " " + e.getYO); 

} 

} ) ; 

repaint ( ) ; 

} 

public void mouseDragged (MouseEvent e) 

{ System. out. println ("Drag "+e.getX() + " " + e.getYO); 
if (! enCours) { xDeb = e.getXO ; yDeb = e.getYO ; 

xFin = xDeb ; yFin = yDeb ; 
enCours = true ; 

} 

else { xFin = e.getXO ; yFin = e.getYO ; 
} 

repaint ( ) ; 

} 

public void mouseMoved (MouseEvent e) { } 
public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 
int xd, xf, yd, yf ; 

xd = Math.min (xDeb, xFin) ; xf = Math. max (xDeb, xFin) ; 
yd = Math.min (yDeb, yFin) ; yf = Math. max (yDeb, yFin) ; 
g.drawRect (xd, yd, xf-xd, yf-yd) ; 

} 



1 . La methode drawRect ne fonctionne pas avec des valeurs negatives pour la hauteur et/ou la largeur. 
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private boolean enCours = false ; 
private int xDeb, yDeb, xFin, yFin ; 

} 

public class Dragl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen. setvisible (true) ; 



} 



} 



Essais drag souris 



Exemple de selection d'une zone par "glisser" de la souris 



Remarque 

L'utilisateur peut selectionner une zone sortant de la partie visible de la fenetre. Dans ce 
cas, seule la partie du rectangle appartenant a la fenetre est visible. 



2 Les evenements lies au clavier 

La plupart du temps, vous n'avez pas a vous preoccuper du clavier car sa gestion est deja 
assuree automatiquement par Java. C'est notamment le cas lors de la saisie d'un texte dans 
une boite de saisie ou dans un champ de texte (les touches de correction telles que Return, 
Backspace, Insert, Delete, fleches droite ou gauche sont convenablement prises en compte). 

Mais parfois, cette gestion automatique s'averera insuffisante. Ce sera le cas si vous souhai- 
tez dessiner dans une fenetre en utilisant les touches du clavier ou encore si vous voulez affi- 
cher des caracteres frappes au clavier. Nous allons voir ici comment proceder pour exploiter 
plus finement les evenements correspondants. 

2.1 Les evenements generes 

Les evenements generes par le clavier appartiennent a la categorie KeyEvent. lis sont geres 
par un ecouteur implementant l'interface KeyListener qui comporte trois methodes : 
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• keyPressed, appelee lorsqu'une touche a ete enfoncee, 

• keyReleased, appelee lorsqu'une touche a ete relachee, 

• keyTyped, appelee (en plus des deux precedentes), lors d'une succession d' actions corres- 
pond a un caractere Unicode. 

Par exemple, la frappe du caractere E entrainera les appels suivants : 

• keyPressed pour l'appui sur la touche Shift, 

• keyPressed pour l'appui sur la touche e, 

• keyReleased pour le relachement de la touche e, 

• keyReleased pour le relachement de la touche Shift, 

• keyTyped pour le caractere E. 

En revanche, la frappe du caractere e (minuscule) n' entrainera que les appels suivants : 

• keyPressed pour l'appui sur la touche e, 

• keyReleased pour le relachement de la touche e, 

• keyTyped pour la frappe du caractere e. 

Si Ton se contente d'appuyer sur une touche telle que Alt et de la relacher, on obtiendra seu- 
lement un appel de keyPressed, suivi d'un appel de keyReleased, sans aucun appel de keyTy- 
ped. 

Vous pouvez ainsi suivre dans le moindre detail les actions de l'utilisateur sur le clavier. Bien 
entendu, si votre but est simplement de lire des caracteres, vous pourrez vous contenter de ne 
traiter que les evenements keyTyped. 



2.2 Identification des touches 

L'objet evenement (de type keyEvent) recu par les trois methodes precedentes contient les 
informations necessaires a 1' identification de la touche ou du caractere concerne. 

D'une part, la methode getKeyChar fournit le caractere conceme (sous la forme d'une valeur 
de type char). 

D' autre part, la methode getKeyCode fournit un entier nomme code de touche virtuelle per- 
mettant d'identifier la touche concernee. II existe dans la classe KeyEvent un certain nombre 
de constantes correspondant a chacune des touches qu'on peut rencontrer sur un clavier. Voici 
les principales : 

VK_0 a VK_9 touches 0 a 9 (pave alphabetique) 

VK_NUMPADO a VK_NUMPAD9 touches 0a9 (pave numerique ) 

VK_A a VK_Z touches AaZ 

VK_F1 a VK_F24 touches fonction Fl a F24 

VK_ALT touche modificatrice Alt 

VK_ALT_GRAPH touche modificatrice Alt graphique 
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Notez bien que ces valeurs permettent d' identifier une "touche logique", c'est-a-dire une 
fonction donnee, independamment de son emplacement physique sur le clavier. Par exemple, 
Femplacement de la touche a n'est pas la meme selon que Ton a affaire a un clavier dit 
"azerty" ou "qwerty". 

Enfin, il existe dans Key Event une methode statique getKeyText qui permet d'obtenir, sous la 
forme d'une chaine, un bref texte expliquant le role d'une touche de code donne. Par exem- 
ple, avec : 

String chl = KeyEvent . getKeyText (VK_SHIFT) ; 

on obtiendra dans chl la chaine "Shift". 




Remarque 



II est possible que certaines touches du clavier ne disposent pas de code de touche vir- 
tuelle. Dans ce cas, Java fournit le code 0 (le texte associe est "Unknown keyCode : 0x0"). 




Precautions 



Lorsqu'une touche possede plusieurs significations (materialisees parplusieurs gravures), 
elle ne dispose generalement que d'un seul code de touche virtuelle. Par exemple, sur un 
clavier francise (AZERTY), la meme touche comporte les trois gravures 3, " et #. Son 
code de touche sera toujours VK_3. On peut toutefois rencontrer quelques exceptions. Par 
exemple, sur un clavier dote d'un pave numerique, la touche gravee 7 et fleche oblique 
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fournira l'un des codes VK_NUMPAD7 ou VK_HOME selon que le clavier est verrouille 
en numerique ou non. 

2.3 Exemple 

Voici un programme qui, depuis une fenetre, gere tous les evenements en provenance du cla- 
vier, en affichant (en fenetre console) : 

• soit le caractere correspondant (keyTyped), 

• soit le code de touche virtuelle correspondant {keyPressed et keyReleased) ; dans ce cas, 
nous utilisons getKeyText pour afficher egalement le texte explicatif associe. 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class MaFenetre extends JFrame implements KeyListener 
{ public MaFenetre () 

{ setTitle ("Exemple lecture clavier") ; 

setSize (300, 180) ; 

addKeyListener (this) ; 

} 

public void keyPressed (KeyEvent e) 
{ int code = e . getKeyCode ( ) ; 

System. out. println ("Touche "+code+ " pressee : " + e. getKeyText (code)) ; 

} 

public void keyReleased (KeyEvent e) 
{ int code = e . getKeyCode ( ) ; 

System. out. println ("Touche"+code+ " relachee : " + e. getKeyText (code)) ; 

} 

public void keyTyped (KeyEvent e) 
{ char c = e . getKeyChar ( ) ; 

System . out . println ("Caractere frappe : " + c + " de code " + (int)c) ; 

} 

} 

public class ClavierO 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 

Caractere frappe : a de code 97 
Touche65 relachee : A 
Touche 90 pressee : Z 
Caractere frappe : z de code 122 
Touche90 relachee : Z 
Touche 155 pressee : Insert 
Touchel55 relachee : Insert 
Touche 35 pressee : End 
Touche35 relachee : End 
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Exemple de gestion des evenements clavier 

2.4 Etat des touches modificatrices 

En plus du code de touche virtuelle ou du caractere associe a un evenement, il est possible de 
connaitre l'etat des touches modificatrices au moment oil il a ete genere. On nomme ainsi les 
touches Shift, Alt, Alt graphic et Cntrl. Pour ce faire, on dispose des methodes suivantes, qui 
fournissent la valeur true si la touche correspondante est pressee, la valeur false dans le cas 
contraire : 



Methode 


Touche correspondante 


isAltDown 

isAltGraphDown 

isControlDown 

isShiftDown 

isMetaDown 


Alt 

Alt graphique 

Cntrl 

Shift 

L'une des quatre preceden- 
tes 



Par ailleurs, la methode getModifiers fournit un entier qui indique l'etat de ces touches et 
qu'on peut tester a l'aide de "masques binaires" definis dans la classe InputEvent : 
ALT_MASK, CONTROL_MASK, SHIFT _MASK et META_MASK : 

void keyPressed (KeyEvent e) 

{ if ( (e.getKeyCodeO == KeyEvent. VK_E) 

&& ( (e. getModifiers () & InputEvent . CTRLJMASK) != 0 )) 
// ici, on a presse la combinaison Cntrl/e} 

} 
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2.5 Source d'un evenement clavier 

La source d'un evenement souris etait tout naturellement le composant sur lequel se trouvait 
le curseur de la souris. Pour le clavier, les choses sont moins "visuelles". En fait, Java consi- 
dere qu'un evenement clavier possede comme source(s) : 

• le composant ayant "le focus" au moment de Faction, 

• les conteneurs eventuels de ce composant. 

On voit que tant que Ton se contente d'intercepter les evenements clavier dans la fenetre 
principale, aucun probleme ne se pose. 

Bien entendu, les composants comme les etiquettes, qui ne peuvent pas recevoir le focus, ne 
pourront pas etre la source d'evenements clavier. Ce point n'est guere genant. 

En revanche, les composants comme les panneaux (JPanel) peuvent poser probleme, car ils 
ne mettent pas en evidence leur focalisation. Ce point pourra devenir sensible lorsque plu- 
sieurs panneaux sont presents dans une meme fenetre. Nous y reviendrons au paragraphe 4. 

2.6 Capture de certaines actions du clavier 

On a deja vu comment associer certaines combinaisons de touches a une option de menu en 
employant des racourcis clavier ou des accelerateurs. Parfois, on souhaitera pouvoir genera- 
liser cette possibility a d'autres actions. Pour ce faire, on dispose de deux demarches. 

La premiere consiste a s' arranger pour intercepter ces actions clavier dans le composant de 
plus haut niveau qu'est la fenetre, quitte a retransmettre les informations necessaires au com- 
posant concerne. La seconde consiste a recourir a des objets action (deja introduits au chapi- 
tre 15) en leur rattachant une combinaison de touches. 

2.6.1 Capture par la fenetre 

La mise en ceuvre de cette premiere demarche ne necessite aucune connaissance autres que 
celles que nous avons deja etudiees. Voici un programme qui permet de modifier la couleur 
d'un panneau en utilisant l'une des combinaisons de touches Ctrl/Alt/r (pour rouge), Ctrl/Alt/ 
b (pour bleu) ou Ctrl/Alt/j (pour jaune). II nous suffit de traitor les evenements keyPressed en 
examinant ceux qui correspondent a l'un des codes de touche r, b ou /', associes aux deux tou- 
ches modificatrices Ctrl et Alt (qu'on teste par isControlDown et LsAltDown). 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Colorations") ; 
setSize (300, 100) ; 

Container contenu = getContentPane ( ) ; 
pan = new JPanel ( ) ; 
contenu. add (pan) ; 
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addKeyListener (new KeyAdapterO 

{ public void keyPressed(KeyEvent e) 

{ if (e.isControlDown() &s e.isAltDown () ) 
{ int touche = e . getKeyCode ( ) ; 
switch (touche) 

{ case KeyEvent.VK_R : pan . setBackground 
case KeyEvent.VK_B : pan . setBackground 
case KeyEvent.VK_J : pan . setBackground 



(Color. red) ; 
(Color. blue) ; 
(Color .yellow) 



break 
break 
break 



} ) 



private JPanel pan ; 

) 

public class ColoreO 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen. setvisible (true) ; 



^Colorations 



HE 



Modification de la couleur d'un panneau par le clavier (1) 

2.6.2 Capture par des actions 

Nous avons appris a creer des objets action et a les associer a une option de menu ou a un 
bouton. La methode registerKeyboardAction (de la classe JComponent) permet d' associer 
une action a une combinaison de touches. On lui fournit trois arguments : 

• Faction concernee (objet de type AbstractAction ou derive) ; 

• la combinaison de touches voulue ; pour ce faire, on utilise une methode statique getKey- 
Stroke (de la classe Keystroke) de la facon suivante : 

Keystroke . getKeyStroke (KeyEvent . VK_R, 

InputEvent . ALT_MASK | InputEvent . CTRL_MASK) 

Ici, KeyEvent. VK_R correspond au code de touche virtuel de la touche r. Le second parame- 
tre correspond aux touches modificatrices ; il utilise les constantes de la classe InputEvent 
presentees precedemment 1 ; 

1 . Une autre version de la methode getKeyStroke possede un troisieme argument de type booleen auquel on donne la 
valeur true pour demander que Taction soit prise en compte au relachement des touches concernees. 
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• les conditions dans lesquelles Taction doit etre provoquee, a savoir Fune des trois possibi- 
lity suivantes : 

- JComponent.WHEN_FOCUSED 

- J Component. WHEN_IN_FOCUSED_WINDOW 

- JComponent. WHEN_ANCESTOR_OF_FOCUSED_COMPONENT. 

En definitive, voici comment associer une action nommee actionRouge a la combinaison de 
touches Ctrl/Alt/r : 

registerKeyboardAction (actionRouge, 
Keystroke . getKeyStroke (KeyEvent . VK_R, 

InputEvent . ALT_MASK | InputEvent . CTRL_MASK) , 
JComponent . WHEN_IN_F0CUSEDJJINCOW) ; 



Exemple 



Voici une adaptation du programme precedent utilisant cette possibility de capture du clavier 
par des actions : 



import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Colorations") ; 
setSize (300, 100) ; 

Container contenu = getContentPane ( ) ; 
pan = new Paneau ( ) ; 
contenu. add (pan) ; 

} 

private Paneau pan ; 

} 

class Paneau extends JPanel 
{ public Paneau () 

{ actionRouge = new ActionCouleur ("rouge", Color. red, this) ; 
actionBleu = new ActionCouleur ("bleu", Color. blue, this) ; 
actionjaune = new ActionCouleur ("jaune", Color. yellow, this) ; 
registerKeyboardAction (actionRouge, 
Keystroke . getKeyStroke (KeyEvent . VK_R, 

InputEvent . ALT_MASK | InputEvent . CTRLJ4ASK) , 
JComponent . WHEN_IN_FOCUSED_WIND3W) ; 
registerKeyboardAction (actionBleu, 

Keystroke . getKeyStroke (KeyEvent . VK_B, 

InputEvent . ALT_MASK | InputEvent . CTRL_MASK) , 
JComponent . WHEN_IN_FOCUSED_WINEOW) ; 
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registerKeyboardAction (actionjaune, 
Keystroke . getKeyStroke (KeyEvent . VK_J, 

InputEvent . ALT_MASK | InputEvent . CTRL_MASK) , 
JComponent.WHEN_IN_EDCUSED_WINEOW) ; 

} 

private ActionCouleur actionRouge, actionBleu, actionjaune ; 

} 

class ActionCouleur extends AbstractAction 

{ public ActionCouleur (String nomCouleur, Color couleur, Paneau pan) 
{ super (nomCouleur) ; 

this .nomCouleur = nomCouleur ; 
this. couleur = couleur ; 
this. pan = pan ; 

} 

public void actionPerformed (ActionEvent e) 
{ pan . setBackground (couleur) ; 

} 

private String nomCouleur ; 
private Color couleur ; 
private Paneau pan ; 

} 

public class Colorel 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 

Modification de la couleur d'un panneau par le clavier (2) 

2.7 Exemple combinant clavier et souris 

Voici un exemple de programme qui affiche des caracteres dans un paneau a un emplacement 
choisi a l'aide de la souris. Chaque clic affiche le dernier caractere saisi au clavier. 

Ici, on utilise un paneau (occupant toute la fenetre). Le dernier caractere frappe est simple- 
ment memorise par un ecouteur (derive ici de KeyAdapter) associe a la fenetre, puis transmis 
a Fobjet paneau par la methode setCaractereCourant. Les clics de la souris sont intercepted 
par un ecouteur (derive de MouseAdapter) situe dans la classe du panneau. 

Pour simplifier les choses, la peinture dans le paneau est faite "a la volee" (voir le paragraphe 
6 du chapitre 12), ce qui evite d' avoir a memoriser les informations (caracteres + coordon- 
nees) correspondantes. Bien entendu, a chaque transformation de la fenetre, les caracteres 
affiches disparaissent. 



import javax. swing.* ; 
import java.awt.* ; 
import j ava . awt . event . * 
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class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Affichage caracteres") ; setSize (300, 180) 
Container contenu = getContentPane ( ) ; 
pan = new PaneauO ; contenu. add (pan) ; 
addKeyListener (new KeyAdapter () 

{ public void keyTyped (KeyEvent e) 

{ pan . setCaractereCourant (e.getKeyChar () ) 



private Paneau pan ; 

} 

class Paneau extends JPanel 
{ public PaneauO 

{ addMouseListener (new MouseAdapter () 

{ public void mouseClicked (MouseEvent e) 
{ Graphics g = getGraphics ( ) ; 

String ch = "" + caractereCourant ; 
g. drawstring (ch, e.getXO, e.getY(J) 
g. disposed ; 



public void paintComponent (Graphics g) 

{ super. paintComponent (g) ; 

} 

public void setCaractereCourant (char c) 

{ caractereCourant = c ; 

} 

private char caractereCourant = ' ' ; 

} 

public class Frappes 

{ public static void main (String args[ ] ) 

{ MaFenetre fen = new MaFenetre () ; fen. setvisible (true) 




Affichage de caracteres a des emplacements choisis par la souris 
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Remarqi 



ue 



Le paragraphe 4.3 vous presentera une generalisation de ce programme a deux panneaux. 



Les fenetres generent des evenements de la categorie WindowEvent lorsqu'elles subissent 
certaines actions telles que l'ouverture, la fermeture ou la reduction en icone. L'ecouteur cor- 
respondant doit implementer 1' interface WindowListener (ou utiliser un adaptateur Window- 
Adapter). 

Voici un exemple de programme qui trace (en fenetre console) les differents evenements 
generes par une fenetre principale : 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class MaFenetre extends JFrame implements WindowListener 
{ public MaFenetre () 

{ setTitle ("Evenements fenetre") ; setSize (300, 100) ; 
addWindowListener (this) ; 

public void windowClosing (WindowEvent e) 

{ System. out .println ("fenetre en cours fermeture") ; 

public void windowOpened (WindowEvent e) 

{ System. out .println ("ouverture fenetre") ; 

public void windowlconified (WindowEvent e) 
{ System. out .println ("fenetre en icone") ; 

public void windowDeiconified (WindowEvent e) 
{ System. out .println ("icone en fenetre") ; 

public void windowClosed (WindowEvent e) 
{ System. out .println ("fenetre fermee") ; 

public void windowActivated (WindowEvent e) 
{ System. out. println ("fenetre activee") ; 



3 Les evenements lies aux fenetres 



3.1 



Generates 



public void windowDeactivated (WindowEvent e) 
{ System. out. println ("fenetre desactivee") ; 
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public class EvFen 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 

fenetre activee 
ouverture fenetre 
fenetre en icone 
fenetre desactivee 
fenetre activee 
icone en fenetre 
fenetre activee 
fenetre en cours fermeture 
fenetre desactivee 

Gestion des evenements fenetre 

3.2 Arret du programme sur fermeture de la fenetre 

Jusqu'ici, nous nous sommes reposes sur une action de l'utilisateur pour obtenir l'arret du 
programme. Comme nous l'avons laisse entendre au paragraphe 1.2 du chapitre 12, nous 
pouvons y parvenir automatiquement en traitant de facon appropriee l'evenement window - 
Closing, c'est-a-dire en ajoutant simplement les instructions suivantes au constructeur de 
notre fenetre : 

class MaFenetre extends JFrame 
{ public MaFenetre () 
{ 

addWindowListener (new WindowAdapter ( ) 

{ public void windowClosing (WindowEvent e) 
{ System. exit (0) ; 
} 

} ) ; 

} 



1 

4 Les evenements lies a la focalisation 

4.1 Generates 



Nous avons deja ete amenes a signaler qu'a un instant donne un seul composant etait 
selectionne, ce qui se traduit par une indication visuelle (telle qu'un encadre en pointille 
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autour du texte associe a un bouton). On dit que ce composant a le focus ou encore qu'il 
detient la focalisation. 

On donne le focus a un composant soit en cliquant dessus, soit en deplacant l'indicateur 
visuel de focalisation a l'aide des touches Tab et Shift/Tab du clavier. On peut agir sur un 
composant ayant le focus a l'aide de la barre d'espace, ce qui equivaut a un clic. 

Lorsqu'un composant a le focus, il peut recevoir les evenements clavier correspondants (si 
Ton a prevu un ecouteur approprie). On peut savoir si un composant donne possede le focus 
en appelant sa methode hasFocus. 

La prise du focus par un composant genere un evenement de la categorie FocusEvent qu'on 
peut traiter par la methode focusGained de F interface FocusListener. De la me me maniere, la 
perte du focus par un composant genere un evenement du meme type, qu'on peut traiter, cette 
fois, par la methode focusLost. C'est ce que nous avions fait (voir paragraphe 4 du chapitre 
13) pour que la perte de focus d'un champ de texte soit considered comme une validation. 

Grace a la methode isTemporary (de la classe FocusEvent), il est possible de savoir si une 
perte de focus est temporaire. Cette situation correspond au cas ou un composant perd le 
focus, suite a un changement de fenetre active ; dans ce cas, en effet, le composant retrouvera 
automatiquement le focus quand l'utilisateur reviendra dans la fenetre correspondante. 

4.2 Forcer le focus 

On peut forcer un composant a recevoir le focus par la methode requestFocus de la classe 
JComponent : 

compo . requestFocus ( ) ; // force le focus sur le composant compo 

Certains composants comme les etiquettes et les panneaux ne peuvent pas recevoir la focali- 
sation. Pour savoir si un composant peut recevoir le focus, on peut recourir a la methode isFo- 
cusTraver sable. Ainsi, avec : 

JPanel pan = new JPanel ( ) ; 
l'expression pan.isFocusTraversablef ) aura la valeur false . 

On peut redefinir la methode isFocusTraversable, de maniere qu'elle renvoie true et ainsi 
obtenir un composant susceptible de recevoir le focus. Mais cela ne suffit pas a provoquer la 
prise de focus sur un clic : il faudra done prevoir un appel explicite a requestFocus. De 
meme, si Ton souhaite beneficier d'une indication visuelle de focus, il faudra la programmer 
explicitement. 




Informations complementaires 



L'ordre dans lequel les differents composants d'un conteneur sont parcourus lorsqu'on 
deplace le focus par le clavier est fixe par l'ordre dans lequel ils ont ete ajoutes au conte- 
neur. On peut toutefois imposer un ordre different, en precis ant un second parametre de 
rang a la methode add, comme dans {compo est un composant, fen une fenetre) : 

fen. add (compo, 4) ; // ajoute compo a fen en le placant en rang 4 
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4.3 Exemple 

Le programme du paragraphe 2.7 affichait dans un paneau des caracteres saisis au clavier. 
Nous vous proposons ici une generalisation a deux panneaux d'une meme fenetre. Chaque 
panneau memorise un caractere courant, correspondant au dernier caractere frappe alors que 
le panneau avait le focus. Chaque clic dans un panneau provoque raffichage du caractere 
courant du panneau a l'emplacement du clic (la peinture se faisant toujours a la volee). 

Nous avons du creer une classe Paneau, derivee de JPanel, en redefinissant la methode isFo- 
cusTraversable. De plus, nous avons prevu qu'un clic dans le panneau lui donne le focus. 

Notez que nous avons utilise pour la fenetre le gestionnaire FlowLayout. Celui-ci tient 
compte des tailles souhaitees pour les composants. Comme un panneau possede, par defaut, 
une tres petite taille, il faut lui en attribuer une en recourant a la methode setPreferredSize 1 . 

import javax. swing.* ; import java.awt.* ; import j ava . awt . event . * ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Affichage caracteres 2 paneaux") ; 
setSize (400, 180) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayout ()) ; 

panl = new Paneau (Color. yellow) ; contenu . add (panl ) ; 

pan2 = new Paneau (Color . cyan) ; contenu . add (pan2 ) ; 

} 

private Paneau panl, pan2 ; 

} 

class Paneau extends JPanel 
{ public Paneau (Color c) 

{ setPreferredSize (new Dimension (160, 100) ) ; 
setBackground (c) ; 
addMouseListener (new MouseAdapter ( ) 

{ public void mouseClicked (MouseEvent e) 
{ Graphics g = getGraphics ( ) ; 

String ch = "" + caractereCourant ; 
g. drawstring (ch, e.getXO, e.getYO) ; 
g. disposed ; 
requestFocus () ; 

} 

} ) ; 

addKeyListener (new KeyAdapterO 

{ public void keyTyped (KeyEvent e) 

{ caractereCourant = e . getKeyChar ( ) ; 
} 

} ) ; 

} 



1 . Un tel probleme ne se pose pas avec BorderLayout qui ne tient pas compte de la taille souhaitee des compo- 
sants. 
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public boolean isFocusTraversable () 

{ return true ; 

} 

private char caractereCourant = ' *' ; 



public class Frappes2 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 



gtfAffichage caracteres 2 paneaux 




Affichage de caracteres dans deux panneaux differents 



Remarque 

En experimental ce programme, vous constaterez qu'il est possible de modifier les 
caracteres courants des deux panneaux en se servant uniquement du clavier. Vous obser- 
verez aussi que si Ton supprime l'appel de requestFocus, on peut toujours placer le focus 
sur l'un des panneaux par le clavier (et done modifier son caractere courant). Mais un clic 
souris ne donne plus le focus au panneau, ce qui se manifeste par le fait qu'un caractere 
frappe ensuite n'est pas pris en compte. 
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Les gestionnaires 
de mise en forme 



Pour chaque conteneur (fenetre, panneau, boite de dialogue, etc.), Java permet de choisir un 
gestionnaire de mise en forme 1 responsable de la disposition des composants. Nous avons 
deja eu l'occasion d'employer des gestionnaires de type FlowLayout ou BorderLayout, sans 
toutefois en approfondir toutes les proprietes. Nous allons maintenant examiner en detail les 
differents gestionnaires de mise en forme proposes par Java. 

Bon nombre d'environnements de developpement disposent d'outils d'aide a la conception 
d' interfaces graphiques qui automatisent plus ou moins l'ecriture du code correspondant. 
Mais, meme dans ce cas, il est possible que vous ayez besoin d'intervenir sur ce code genere 
et done d'en comprendre le fonctionnement. 

Outre les deux gestionnaires que nous avons deja rencontres, nous etudierons : 

• CardLayout : il permet de disposer des composants suivant une pile, a la maniere d'un pa- 
quet de cartes, un seul composant etant visible a la fois ; 

• GridLayout : il permet de disposer les composants suivant une grille reguliere, chaque com- 
posant ayant la meme taille ; 

• BoxLayout : il permet de disposer des composants suivant une meme ligne ou une meme co- 
lonne, mais avec plus de souplesse que le precedent ; 

• GridBagLayout : comme GridLayout, il permet de disposer les composants suivant une 
grille, mais ceux-ci peuvent occuper plusieurs cellules ; en outre, on peut imposer diverses 



1 . En anglais Layout manager. On dit aussi gestionnaire de disposition, ou parfois de positionnement. 



Les gestionnaires de mise en forme 

Chapitre 17 



"contraintes" indiquant comment la taille des cellules peut etre modifiee ail fil de 
F execution ; 

• GroupLayout (introduit par Java 6, surtout pour faciliter le travail des generateurs 
automatiques) : il permet de definir plusieurs groupes de composants a l'interieur d'un 
meme conteneur. 



1 Le gestionnaire BorderLayout 

Le gestionnaire BorderLayout dispose les composants suivant l'un des quatre bords du conte- 
neur ou au centre. 

Les composants deposes sur l'un des bords ont une epaisseur fixe, et le composant depose au 
centre occupe Fespace laisse libre. Tant qu'un bord n'est pas occupe par un composant, 
l'espace correspondant est utilisable par le composant central. 

On choisit l'emplacement d'un composant en fournissant en argument de la methode add 
l'une des constantes entieres suivantes (on peut utiliser indifferemment le nom de constante 
ou sa valeur) : 



Constante symbolique 


Valeur 


Emplacement correspondant 


BorderLayout. NORTH 


"North" 


En haut 


BorderLayout.SOUTH 


"South" 


En bas 


BorderLayout.EAST 


"East" 


A droite 


BorderLayout.WEST 


"West" 


A gauche 


BorderLayout.CENTER 


"Center" 


Au centre 



Le parametre de placement d'un composant avec BorderLayout 



Si aucune valeur n'est precisee a la methode add, le composant est place au centre. 

Par defaut, les composants sont espaces de 5 pixels. On peut demander un intervalle different 
au moment de la construction du gestionnaire, comme dans cet exemple applique a un conte- 
neur nomme conteneur : 

conteneur . setLayout (new BorderLayout (10, 20)) ; 

Ici, on obtiendra entre les composants un intervalle horizontal de 10 pixels et un intervalle 
vertical de 20 pixels. 

On peut egalement agir sur cet intervalle apres construction en utilisant les methodes 
setHgap ou setVgap de la classe BorderLayout. Dans ce cas, il est necessaire de conserver la 
reference au gestionnaire, comme dans cet exemple : 

BorderLayout g = new BorderLayout ( ) ; 

g. setHgap (15) ; // intervalle horizontal entre composants de 15 pixels 

g.setVgap (8) ; // intervalle vertical entre composants de 8 pixels 

conteneur . setLayout (g) ; 
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Voici un petit programme d' illustration. II place un bouton dans chacune des cinq zones du 
contenu (getContentPanef )) d'une fenetre, lequel dispose par defaut d'un gestionnaire Bor- 
derLayout. Differents exemples d' execution montrent ensuite comment evolue la disposition 
des boutons lorsque Futilisateur retaille la fenetre. On remarquera que les zones des bords 
conservent une taille fixe. 



import javax. swing.* ; 

import java.awt.* ; 

class MaFenetre extends JFrame 

{ public static int NEOOTONS = 5 ; 

public MaFenetre () 

{ setTitle ("Exemple BorderLayout") ; 
setSize (300, 180) ; 

Container contenu = getContentPane ( ) ; 

boutons = new JButtonf NEOUTONS] ; 

for (int i=0 ; KNEOUTONS ; boutons[ i] 



new JButton ("Bouton " + i) 



contenu . add (boutonsf 0] ) 
contenu . add (boutonsf 1] , 
contenu . add (boutonsf 2] , 
contenu . add (boutonsf 3] , 
contenu . add (boutonsf 4] , 

} 

private JButton boutonsf ] 



; // au centre par defaut 

BorderLayout . NORTH) ; 
BorderLayout . SOUTH) ; 
BorderLayout. WEST) ; 
BorderLayout . EAST ) ; 



public class Layoutl 

{ public static void main (String argsf ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen. setvisible (true) ; 
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Exemple d' utilisation d'un gestionnaire BorderLayout 
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2 Le gestionnaire FlowLayout 

Comme nous Favons vu, le gestionnaire FlowLayout dispose les composants les uns a la 
suite des autres, sur une meme ligne. Lorsqu'une ligne ne possede plus suffisamment de 
place, Faffichage se poursuit sur la ligne suivante. 

Contrairement a ce qui se produisait avec BorderLayout, la taille des composants est respec- 
tee. Celle-ci est definie par defaut suivant la nature et le contenu du composant. Par exemple, 
la longueur des libelles ainsi que la police utilisee pourront influer sur la taille d'un bouton, 
d'une etiquette ou d'une boite de liste. 

On peut toujours imposer une taille a un composant en utilisant la methode setPreferredSize 
(on lui fournit un objet de type Dimension dont le constructeur recoit en argument deux 
entiers correspondant a la largeur et a la hauteur voulues). Nous en avons deja rencontre un 
exemple avec des boutons au paragraphe 7.3 du chapitre 12 ainsi qu'un exemple avec des 
panneaux au paragraphe 4.3 du chapitre 16 (par defaut, les panneaux sont de tres petite 
taille). 

Lors de la construction d'un gestionnaire FlowLayout, on peut specifier un parametre d'ali- 
gnement d'une ligne de composants par rapport aux bords verticaux de la fenetre. Pour cela, 
on utilise l'une des constantes entieres suivantes (on peut prendre indifferemment le nom de 
constante ou sa valeur) : 



Constante symbolique 


Valeur 


Alignement correspondant de la ligne de compo- 
sants 


FlowLayout. LEFT 

FlowLayout.RIGHT 

FlowLayout.CENTER 


"Left" 

"Right" 

"Center" 


A gauche (valeur par defaut) 
A droite 
Au centre 



Le parametre d' alignement d'un FlowLayout 



Par exemple, avec : 

conteneur . setLayout (new FlowLayout (FlowLayout.CENTER)) ; 

les composants seront centres sur les differentes lignes. 

Notez que ce choix est fait une fois pour toutes a la construction : toutes les lignes de compo- 
sants suivront toujours le meme alignement. 

Enfin, toujours lors de la construction, on peut specifier un intervalle entre les composants 
(par defaut, il est de 5 pixels, dans les deux directions). Dans ce cas, il faut aussi specifier le 
parametre d' alignement en premier argument, comme dans cet exemple : 

conteneur . setLayout (new FlowLayout (FlowLayout.RIGHT, 10, 15)) ; 



2 - Le gestionnaire FlowLayout 




Les mefhodes setHgap et setVgap, presentees pour BorderLayout, peuvent egalement etre 
utilisees apres la construction. Dans ce cas, il faut conserver la reference au gestionnaire, 
comme dans cet exemple : 

FlowLayout g = new FlowLayout ( ) ; 



conteneur . setLayout ( g ) ; 
Voici un petit programme d' illustration. II place huit 1 boutons dans une fenetre. On utilise un 
gestionnaire FlowLayout, avec un alignement centre, un intervalle horizontal de 15 pixels et 
un intervalle vertical de 5 pixels. Les libelles des boutons ont ete definis de telle sorte que 
leur longueur ne soit pas la meme pour tous les boutons. 

Differents exemples d' execution montrent ensuite comment evolue la disposition des bou- 
tons lorsque l'utilisateur retaille la fenetre. 

import javax. swing.* ; 
import java.awt.* ; 

class MaFenetre extends JFrame 

{ public static int NEOOTONS = 8 ; 

public MaFenetre () 

{ setTitle ("Exemple FlowLayout") ; 
setSize (350, 180) ; 

Container contenu = getContentPane ( ) ; 

contenu . setLayout (new FlowLayout (FlowLayout. CENTER, 10, 5)) ; 
boutons = new JButton[ NEOOTONS] ; 
int n = 1 ; 

for (int i=0 ; KNBOUTONS ; i++) 
{ boutons[ i] = new JButton ("Bouton " + n) ; 
n *= 10 ; 

contenu . add (boutons[ i] ) ; 

} 

} 

private JButton boutons[ ] ; 



g. setHgap (15) 
g.setVgap (8) 



// intervalle horizontal entre composants de 15 pixels 
// intervalle vertical entre composants de 8 pixels 



public class Layout2 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 



1. Cette valeur, definie par la constante symbolique NBOUTONS, est facilement modifiable. 
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Exemple d' utilisation d'un gestionnaire FlowLayout 



Remarque 

En combinant des gestionnaires aussi simples que BorderLayout et FlowLayout, on peut 
aboutir a des presentations elaborees. En effet, parmi les composants disposes par un ges- 
tionnaire, on peut trouver un ou plusieurs conteneurs (souvent des panneaux) qui pourront 
posseder leur propre gestionnaire. Nous avons rencontre un exemple de ce type au para- 
graphe 7 du chapitre 13. 



3 Le gestionnaire CardLayout 

Le gestionnaire CardLayout permet de disposer des composants suivant une pile, de telle 
facon que seul le composant superieur soit visible a un moment donne. Des methodes per- 
mettent de parcourir la pile ou encore de se placer sur un composant donne. 

A la creation d'un tel gestionnaire, on peut preciser des "retraits" entre le composant et le 
conteneur, par exemple : 
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CardLayout pile = new CardLayout (30, 20) ; // 30 pixels de part et d' autre, 

// 20 pixels en haut et en bas 
Le choix de ce gestionnaire pour un conteneur nomme conteneur se fait classiquement : 

conteneur . setLayout (pile) ; 

En general, il sera necessaire de conserver la reference a Fobjet gestionnaire (ici pile) ; on ne 
pourra pas se contenter d'ecrire directement : 

conteneur . setLayout (new CardLayout (30, 20)) ; 

Lors de l'ajout d'un composant donne compo au conteneur concerne, on doit obligatoirement 
fournir, en second argument de add, une chaine servant a identifier le composant 1 au sein du 
conteneur, par exemple : 

conteneur . add (compo, "un certain composant") ; 

Notez que, meme si cette identification n'est pas necessaire a la suite du programme, P argu- 
ment correspondant doit etre fourni (on peut utiliser une chaine vide). Dans le cas contraire, 
on obtiendra une erreur d' execution. 

Par defaut, le composant visible est le premier ajoute au conteneur. On peut faire apparaitre 
un autre composant de la pile, de Pune des facons suivantes (notez que la reference au conte- 
neur est utile) : 

pile. next (conteneur) ; // affiche le composant suivant 

pile. previous (conteneur) ; // affiche le composant precedent 
pile. first (conteneur) ; // affiche le premier composant 

pile. last (conteneur) ; // affiche le dernier composant 

Enfin, on peut faire apparaitre un composant d' identification donnee a Paide de la methode 
show, par exemple : 

pile. show (conteneur, "un certain composant") ; // affiche le composant 

// identifie par la chaine "un certain composant" 

Voici un petit programme d'illustration. II cree une pile de huit boutons dans un premier pan- 
neau. Un second panneau contient des boutons permettant de parcourir la pile a Paide des 
fonctions next, previous, first et last . 

import javax. swing.* ; import java.awt.* ; 
import java.awt. event.* ; import javax. swing. event.* ; 
class MaFenetre extends JFrame implements ActionListener 
{ public static int NEODTONS = 8 ; 
public MaFenetre () 

{ setTitle ("Exemple CardLayout") ; setSize (400, 180) ; 
Container contenu = getContentPane ( ) ; 
panCard = new JPanelO ; // panneau pour la pile 
contenu . add (panCard) ; 

panCom = new JPanelO ; // panneau pour les boutons de parcours de la pile 
contenu. add (panCom, "South") ; 



1. Ne confondez pas cette chaine avec le libelle qui figure sur certains composants, tels que les boutons, meme 
si, dans ce cas, on utilise souvent le meme texte pour les deux. 
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I* creation de la pile de boutons * / 
pile = new CardLayout (30, 10) ; 
panCard . setLayout (pile) ; 
boutons = new JButton[ NEOUTONS] ; 
for (int i=0 ; KNB0U1DNS ; i++) 
{ boutons[ i] = new JButton ("Bouton " + i) ; 

panCard.add(boutons[ i] , "Bouton") ; // identification obligatoire ici 

} 

/* creation des boutons de parcours de la pile */ 
prec = new JButton ("precedent") ; panCom.add (prec) ; 
prec.addActionListener (this) ; 

suiv = new JButton ("suivant") ; panCom.add (suiv) ; 
suiv.addActionListener (this) ; 

prem = new JButton ("premier") ; panCom.add (prem) ; 
prem.addActionListener (this) ; 

der = new JButton ("dernier") ; panCom.add (der) ; 
der.addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent e) 
{ JButton source = (JButton) e.getSource () ; 

if (source == prec) pile. previous (panCard) ; 

if (source == suiv) pile. next (panCard) ; 

if (source == prem) pile. first (panCard) ; 

if (source == der) pile. last (panCard) ; 

} 

private JButton boutons[ ] ; 

private JPanel panCard, panCom ; 

private CardLayout pile ; 

private JButton prec, suiv, prem, der ; 

} 

public class Layout3 

( public static void main (String args[ ] ) 

{ MaFenetre fen = new MaFenetreO ; fen. setvisible (true) ; 
} 
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4 Le gestionnaire GridLayout 

Le gestionnaire GridLayout permet de disposer les differents composants suivant une grille 
reguliere, chaque composant occupant une cellule. 

A la construction, on choisit le nombre de lignes et de colonnes de la grille et, eventuelle- 
ment, des intervalles entre les composants, comme dans : 

conteneur . setLayout (new GridLayout (5, 4)) ; // 5 lignes, 4 colonnes 

ou dans : 

conteneur . setLayout (new GridLayout (5, 4, 15, 10)) ; // 5 lignes, 4 colonnes 
// intervalle horizontal de 15, intervalle vertical de 10 

Les composants sont affectes aux differentes cases, en fonction de Fordre dans lequel on les 
ajoute au conteneur (le parcours se fait suivant les lignes). II est possible que les demieres 
cases restent vides. Toutefois, si vous laissez plus d'une ligne vide, le gestionnaire 
reorganisera la grille, de facon a eviter une perte de place. 

Voici un petit programme d' illustration. II place 10 boutons dans une fenetre, en utilisant une 
grille 4x3. Differents exemples d' execution montrent ensuite comment evolue la disposition 
des boutons lorsque Futilisateur retaille la fenetre. Notez que si nous cherchions a agir sur les 
tailles (preferentielle, maximale ou minimale) des composants, aucune des valeurs mention- 
nees ne serait utilisee. 

import javax. swing.* ; 
import java.awt.* ; 

class MaFenetre extends JFrame 

{ public static int NBOOTONS = 10 ; 

public MaFenetre () 

{ setTitle ("Exemple GridLayout") ; 
setSize (350, 180) ; 

Container contenu = getContentPane ( ) ; 
contenu . setLayout (new GridLayout ( 4 , 3, 6, 4)) ; 
boutons = new JButton[ NEOUTONS] ; 
for (int i=0 ; KNBOUTONS ; i++) 
{ boutons[ i] = new JButton ("Bouton " + i) ; 
contenu . add (boutons[ i] ) ; 

} 

} 

private JButton boutons[ ] ; 

1 

public class Layout4 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Exemple d' utilisation d'un gestionnaire GridLayout 



5 Le gestionnaire BoxLayout 



5.1 Generalit.es 



Le gestionnaire BoxLayout permet de disposer des composants suivant une seule ligne ou une 
seule colonne. Cependant, associe au conteneur particulier qu'est Box 1 , il permet une certaine 
souplesse que n'offrirait pas un GridLayout a une seule ligne ou une seule colonne. C'est 
done uniquement dans ce contexte que nous vous presenterons ce gestionnaire BoxLayout. 

On cree un "box horizontal" avec la methode statique createHorizontalBox : 

Box ligne = Box. createHorizontalBox () ; // box horizontal 

De la meme maniere, on cree un "box vertical" avec la methode statique createVerticalBox : 

Box ligne = Box . createVerticalBox () ; // box vertical 

Un tel conteneur est dote par defaut d'un gestionnaire de type BoxLayout. 

Pour fixer les idees, supposons que nous avons affaire a un box horizontal. Les composants, 
ajoutes classiquement par add, sont disposes de gauche a droite ; ils sont contigus et occupent 
toute la largeur et toute la hauteur du conteneur. A cet effet, ils sont etires ou retrecis dans la 



1. Attention : bien que ce soit un composant swing, Box (et non JBox) ne derive pas de JComponent. II ne pos- 
sede done pas de methode paintComponent. II est done preferable d'eviter de dessiner sur un tel conteneur. 
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mesure du possible. Si tous les composants ne peuvent pas tenir dans la largeur de la fenetre, 
certains ne seront pas visibles. 

5.2 Exemple de box horizontal 

Voici un petit programme d'illustration. II cree dans la fenetre un box horizontal, dans lequel 
il place un bouton, un champ de texte (de longueur 20), une case a cocher et une etiquette. 
Differents exemples d' execution montrent ensuite comment evolue la disposition de ces trois 
composants lorsque Futilisateur retaille la fenetre. On notera que, par defaut, les boutons, les 
cases a cocher et les etiquettes ne peuvent pas etre etires ou retrecis ; en revanche, les champs 
texte peuvent etre etires a volonte (y compris, curieusement dans le sens de la hauteur). 

import javax. swing.* ; 
import java.awt.* ; 

class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Exemple BoxLayout horizontal") ; 
setSize (550, 100) ; 

Container contenu = getContentPane ( ) ; 

bHor = Box. createHorizontalBox () ; 

contenu. add (bHor) ; 

bl = new JButton ("Boutonl") ; 

bHor. add (bl) ; 

txt = new JTextField (20) ; 

bHor. add (txt) ; 

cochel = new JCheckBox ("case a cocher") ; 

bHor . add ( coche 1 ) ; 

etiq = new Jlabel ("Bon jour") ; 

bHor. add (etiq) ; 

} 

private Box bHor ; 
private JButton bl ; 
private JCheckBox cochel ; 
private JTextField txt ; 
private Jlabel etiq ; 

} 

public class Layout5 

{ public static void main (String args! ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

1 
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Exemple d' utilisation d'un box horizontal 

Remarque 

Ici, setPreferredSize et setColumns n'auraient aucun effet sur le champ texte. En revan- 
che, sa taille minimale et sa taille maximale seraient bien prises en compte. On notera 
que, par defaut, la taille maximale d'un champ texte est infinie (dans les deux directions), 
d'oii l'effet constate. 

5.3 Exemple de box vertical 

Voici une simple transposition de l'exemple precedent a un box vertical : 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Exemple BoxLayout horizontal") ; 

setSize (200, 150 ) ; 

Container contenu = getContentPane ( ) ; 

bVert = Box . createVerticalBox ( ) ; 

contenu. add (bVert) ; 

bl = new JButton ("Boutonl") ; 

bVert.add (bl) ; 

txt = new JTextField (20) ; 

bVert.add (txt) ; 

cochel = new JCheckBox ("case a cocher") ; 
bVert . add ( coche 1 ) ; 
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etiq = new JLabel 
bVert . add (etiq) ; 



( "Bon j our" ) 



} 

private Box bVert ; 
private JButton bl ; 
private JCheckBox cochel ; 
private JTextField txt ; 
private JLabel etiq ; 

} 

public class Layout6 

{ public static void main (String args[ ] 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 




Exemple d' utilisation d'un box vertical 

5.4 Modifier I'espacement avec strut et glue 

Nous avons vu que le gestionnaire BoxLayout peut jouer sur les dimensions de certains com- 
posants afin d'occuper tout l'espace disponible. Mais, d'une part, tous les composants ne sont 
pas adaptables, et d'autre part, la disposition obtenue en utilisant une telle "elasticite" n'est 
pas toujours satisfaisante. 

Java offre deux outils complementaires pour agir sur cette disposition. Tout d'abord, vous 
pouvez creer des composants virtuels de taille donnee, ce qui permet de fixer des espaces pre- 
cis entre certains composants. D'autre part, vous pouvez forcer certains composants a s'eloi- 
gner au maximum les uns des autres. 
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Plus precisement, pour un box vertical, vous pouvez creer un composant virtuel de hauteur 
donnee, a l'aide de la methode statique createVerticalStrut de la classe Box : 

Box . createVerticalStrut (10) // fournit la reference a un composant 

// virtuel de 10 pixels de haut 

Vous l'ajoutez ensuite classiquement au Box a l'aide de la methode add. Quoi qu'il arrive, il 
subsistera toujours un espace de 10 pixels entre les composants situes de part et d'autre de ce 
composant virtuel (ou entre un composant et le bord du Box). 

Pour les Box horizontaux, on dispose d'une methode similaire, nommee createHorizontal- 
Strut. 

D'autre part, la methode statique createGluef) cree un emplacement virtuel de taille entiere- 
ment ajustable. Celle-ci est determinee par le gestionnaire de facon a espacer au maximum 
les composants situes de part et d'autre (ou un composant d'un bord). 

Voici un exemple dans lequel nous placons dans un Box vertical : 

• deux boutons, separes par un espace (strut) de 10 pixels ; 

• une case a cocher, eloignee au maximum (glue) des boutons. 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ public MaFenetre () 

{ setTitle ("Exemple strut et glue") ; 
setSize (150, 200) ; 

Container contenu = getContentPane ( ) ; 
bVert = Box . createVerticalBox ( ) ; 
contenu. add (bVert) ; 
bl = new JButton ("Boutonl") ; 
bVert.add (bl) ; 

bVert.add (Box. createVerticalStrut (10) ) ; // espace 10 pixels 
b2 = new JButton ("Bouton2") ; 
bVert.add (b2) ; 

bVert.add (Box . createGlue ( ) ) ; // espacement maximal 

cochel = new JCheckBox ("case a cocher") ; 
bVert.add (cochel) ; 

} 

private Box bVert ; 
private JButton bl, b2 ; 
private JCheckBox cochel ; 

} 

public class Layout7 

( public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Exemple d' utilisation de createStrut et de createGlue 



Remarque 

Dans cet exemple, nous n'avons pas conserve de champ texte. En effet, ce dernier etant 
totalement "elastique", l'effet de createGlue n'aurait jamais pu etre percu. 



6 Le gestionnaire GridBagLayout 



6.1 Presentation generale 



Ce gestionnaire est de loin le plus souple, mais aussi le plus difficile a employer. A I'instar 
de GridLayout, il permet de disposer les composants suivant une grille mais, cette fois, ceux- 
ci peuvent occuper plusieurs cases. 

La construction d'un tel gestionnaire se fait par appel d'un constructeur sans argument : 

GridBagLayout g = new GridBagLayout ( ) ; 

A ce niveau, on ne fournit aucune information quant au nombre de lignes ou de colonnes. 

Ensuite, on ajoute chaque composant en fournissant a la mefhode add un deuxieme argument 
de type GridBagConstraints, dans lequel on precise un certain nombre de parametres (sous 
forme de valeurs de champs publics) utiles pour le placement du composant dans le conte- 
neur. 
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Parmi ces parametres figurent des informations relatives a la localisation du composant sur 
une grille fictive : coordonnees du coin superieur gauche du composant, etendue horizontale 
et etendue verticale - toutes ces valeurs sont exprimees en nombre de cases, dans le sens 
horizontal ou vertical. Toutefois, un peu curieusement, celles-ci ne suffisent pas a obtenir un 
resultat satisfaisant ; si on se limite a cela, les composants occuperont souvent leur taille pre- 
ferentielle... 

En fait, il est egalement necessaire de fixer des "poids" a chacune des deux dimensions (hori- 
zontale et verticale) de chaque composant. Ces poids seront utilises par le gestionnaire pour 
en fixer la taille, en fonction de l'espace global disponible. En general, il est preferable de 
considerer que ce sont ces poids qui definissent approximativement la taille d'un composant, 
tandis que les composants n' ay ant pas de poids (ou plutot un poids nul) sont disposes en 
exploitant les informations de localisation dans la grille. 

Les poids sont des nombres entiers quelconques. Par commodite, on fera en sorte que la 
somme des poids dans une direction donnee soit de 100 ou de 1000... 

Enfin, il faut generalement fournir un parametre indiquant la maniere dont le composant 
occupera l'espace disponible. Notamment, on peut choisir de laisser des espaces autour du 
composant ou, au contraire, qu'il soit etire pour occuper l'espace disponible. 

Voici une recapitulation des parametres evoquees (il en existe quelques autres, peu 
importants) : 



Parametre 


Signification 


gridx 


Abscisse dans la grille du coin superieur gauche du composant 


gridy 


Ordonnee dans la grille du coin superieur gauche du composant 


gridwidth 


Largeur du composant 


gridheight 


Hauteur du composant 


weightx 


Poids horizontal du composant (eventuellement 0) 


weighty 


Poids vertical du composant (eventuellement 0) 


fill 


Maniere dont le composant occupe l'espace disponible : 

- GridBagConstraints.HORIZONTAL : largeur ajustee a l'espace disponible 

- GridBagConstraints.VERTICAL : hauteur ajustee a l'espace disponible 

- GridBagConstraints.BOTH : largeur et hauteur ajustees a l'espace disponible 

- GridBagConstraints.NONE : aucun ajustement 



Les principaux champs (publics) d'un objet de type GridBagConstraints 



6.2 Exemple 

L'exemple de programme suivant utilise un gestionnaire GridBagLayout. Dans une grille Ac- 
tive de 4 lignes et de 5 colonnes, nous avons cherche a disposer six boutons suivant ce 
schema : 
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B1 


B2 


B3 


B4 


B6 


B5 



Nous avons utilise ce schema pour determiner les parametres gridx, gridy, gridwidth et grid- 
height de nos composants. Nous avons impose un poids non nul pour : 

• les largeurs de Bl (60) et de B2 (40) ; 

• les hauteurs de B2, B3, B4 et B5 (25 dans chaque cas). 

Voici le programme ainsi obtenu, avec quelques exemples montrant comment evolue la dis- 
position lorsque l'utilisateur retaille la fenetre. 

import javax. swing.* ; 

import java.awt.* ; 

class MaFenetre extends JFrame 

{ public static int NBOU1DNS = 10 ; 



public static int xl ] = 


{ o, 


3, 


3, 


0, 


0, 


3} 


public static int y[ ] = 


{ o, 


0, 


1, 


2, 


3, 


2} 


public static int larg[ ] 


= { 3, 


2, 


2, 


3, 


3, 


2} 


public static int hautf ] 


= { 2, 


1, 


1, 




1, 


2} 


public static int px [ ] 


= { 60, 


40, 


0, 


o, 


0, 


0} 


public static int py [ ] 


= { 0, 


25, 


25, 


25, 


25, 


0} 



public MaFenetre () 

{ setTitle ("Exemple GridBagLayout") ; 
setSize (350, 180) ; 

Container contenu = getContentPane ( ) ; 
GridBagLayout g = new GridBagLayout ( ) ; 
contenu . setLayout (g) ; 

GridBagConstraints c = new GridBagConstraints ( ) ; 
c.fill = GridBagConstrainsts.BOTH ; 
for (int i = 0 ; i<x. length ; i++) 
{ c. gridx = xt i] ; c. gridy = y[ i] ; 

c. gridwidth = larg[ i] ; c.gridheight = hautf i] ; 

c. weigh tx = pxt i] ; c. weighty = py[ i] ; 

contenu. add (new JButton ("Bouton"+ (i+1) ) , c) ; 

} 

} 

} 

public class GridBag 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 



Les gestionnaires de mise en forme 

Chapitre 17 



I^Exemple Grid Bag Layout I 


Boutonl 


Bouton2 


Bouton3 


Bouton4 


Bouton6 


BoutonS 



j^Exemple Grid...HHI3 


Boutonl 


Bouton2 


Boutorrt 


Bouton4 


Boirton6 


Bouton6 



||jjf Exemple GridBagLayout 


_|n|x 


Boutonl 


Bouton2 


BoutonS 


Bouton4 


Boutonfi 


BoutonS 



Exemple d' utilisation d'un gestionnaire GridBagLayout 



Remarques 

1 En toute rigueur, les poids portent, non pas sur Fintegralite de la taille du composant, 
mais uniquement sur l'espace s'etendant au-dela de sa taille preferentielle. Vous pouvez 
le constater en examinant le deuxieme exemple d' execution, dans lequel la largeur de la 
fenetre a ete suffisamment reduite. 

2 En theorie, le gestionnaire GridBagLayout permet de dessiner n'importe quelle imple- 
mentation de composants, aussi sophistiquee soit-elle. Neanmoins, il ne faut pas perdre 
de vue que plus vous chercherez a rigidifier votre disposition, plus Java aura du mal a 
s'adapter a des situations perturbatrices telles que la modification de la taille de la fene- 
tre ou des polices des textes, l'execution dans des environnements differents... 



7 Le gestionnaire GroupLayout 

Java 6 a introduit un nouveau gestionniare GroupLayout plutot destine a faciliter le travail 
des generateurs automatiques d' interfaces graphiques. Mais il reste utilisable par le program- 
meur. Son fonctionnement ne nous a pas semble tres intuitif, de sorte que nous avons prefere 
l'introduire sur un exemple tres simpliste, avant d'en montrer les differentes possibilites. 
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7.1 Exemple d'introduction 

A priori, comme le laisse penser son nom, ce gestionnaire est destine a creer plusieurs grou- 
pes de composants dans un me me conteneur. Mais il necessite qu'on definisse la facon dont 
les composants d'un meme groupe seront disposes, a la fois suivant l'axe horizontal et sui- 
vant l'axe vertical. En outre, assez curieusement, il demande de decrire de facon totalement 
separee la disposition horizontale et la disposition verticale, de sorte que chaque composant 
semble "cite" deux fois. 

Voici un premier exemple oil nous utilisons GroupLayout pour creer un seul groupe de quatre 
boutons disposes horizontalement : 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ public static int NEOOTONS = 4 ; 
public MaFenetre () 

{ setTitle ("Exemple GroupLayout 1") ; 
setSize (400, 80) ; 

Container contenu = getContentPane ( ) ; 
boutons = new JButtonf NEOUIDNS] ; 

for (int i=0 ; KNBOUTONS ; i++) boutons[ i] = new JButton ("Bouton " + i) ; 

GroupLayout ges = new GroupLayout (contenu) ; 
contenu . setLayout (ges ) ; 

// hg = description horizontale du groupe 
GroupLayout . SequentialGroup hg = ges . createSequentialGroup ( ) ; 
ges.setHorizontalGroup(hg) ; 

for (JButton bouton : boutons) hg . addComponent (bouton) ; 

// hv = description verticale du groupe 
GroupLayout. ParallelGroup hv = ges.createParallelGroup () ; 
ges . setVerticalGroup (hv) ; 

for (JButton bouton : boutons) hv . addComponent (bouton) ; 

} 

private JButton boutons[ ] ; 

} 

public class TestGroupLayoutl 
{ public static void main (String args! ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 



} 
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Le debut du programme est classique ; nous creons quatre boutons et nous installons un ges- 
tionnaire de type GroupLayout. Ensuite, nous allons devoir "decrire" deux fois notre groupe 
(que nous souhaitons horizontal) : 

• une fois horizontalement, en indiquant que nos boutons sont places sequentiellement sui- 
vant cet axe ; 

• une fois verticalement, en indiquant que nos boutons sont places parallelement a cet axe. 

Pour ce faire, nous creons un groupe sequentiel nomme hg (de type GroupLayout.Sequential- 
Group) et nous lui donnons l'attribut horizontal par setHorizontalGroup. De meme, nous 
creons un groupe parallele nomme hv (de type GroupLayout. ParallelGroup) et nous lui don- 
nons l'attribut vertical par setVerticalGwup. Nous ajoutons enfin nos quatre boutons aux 
deux groupes. 



Remarques 

1 Si nous conservions les definitions de hg et de hv, en inversant les attributs horizontal et 
vertical, c'est-a-dire, en utilisant : 

ges . setVerticalGroup (hg) ; 



ges . setHorizontalGroup (hv) ; 

Nous obtiendrions un groupe de quatre boutons disposes verticalement. 

Si nous avions utilise deux "descriptions" sequentielles suivant chacune des deux dire- 
tions, en utilisant : 

GroupLayout . SequentialGroup hg = ges . createSequentialGroup () ; 



GroupLayout . SequentialGroup hv = ges. createSequentialGroup () 

nous aurions obtenu une disposition "en diagonale" : 
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7.2 Exemple avec deux groupes 

Nous vous proposons maintenant un exemple oil nous definissons deux groupes places cote a 
cote, et comportant chacun trois boutons disposes l'un au dessus de 1' autre. Pour ce faire, 
nous decrivons chacune de nos colonnes de trois boutons a la fois comme un groupe parallele 
suivant l'axe horizontal et comme un groupe sequentiel suivant l'axe vertical. 

Nous creons ensuite un groupe sequentiel horizontal dans lequel nous introduisons la des- 
cription horizontale de nos deux groupes. 

De meme, nous creons un groupe parallele vertical dans lequel nous introduisons la descrip- 
tion verticale de nos deux groupes. 

import javax. swing.* ; 
import java.awt.* ; 

class MaFenetre extends JFrame 
{ public static int NEOOTONS = 6 ; 
public MaFenetre () 

{ setTitle ("Exemple GroupLayout 2") ; 
setSize (400, 150) ; 

Container contenu = getContentPane ( ) ; 
boutons = new JButtorf NEOUTONS] ; 

for (int i=0 ; KNBOUTONS ; i++) boutons! i] = new JButton ("Bouton " + i) ; 
GroupLayout ges = new GroupLayout (contenu) ; 
contenu. setLayout (ges) ; 

ges . setAutoCreateGaps (true) ; // pour espacer les composants entre eux 

ges . setAutoCreateContainerGaps (true) ; // pour espacer les composants du bord 

// description premiere colonne 1 suivant les deux axes 
GroupLayout. ParallelGroup collh = ges .createParallelGroup () ; 

collh.addComponent (boutons[ 0] ) ; 

collh.addComponent (boutons[ 2] ) ; 

collh.addComponent (boutons[ 4] ) ; 
GroupLayout . SequentialGroup collv = ges . createSequentialGroup ( ) ; 

collv. addComponent (boutonst 0] ) ; 

collv. addComponent (boutons[ 2] ) ; 

collv.addComponent (boutons[ 4] ) ; 

// description deuxieme colonne suivant les deux axes 
GroupLayout. ParallelGroup col2h = ges .createParallelGroup () ; 

col2h . addComponent (boutonst 1] ) ; 

col2h . addComponent (boutonst 3] ) ; 

col2h . addComponent (boutonst 5] ) ; 
GroupLayout . SequentialGroup col2v = ges . createSequentialGroup ( ) ; 

col2v . addComponent (boutonst 1] ) ; 

col2v. addComponent (boutonst 3] ) ; 

col2v. addComponent (boutonst 5] ) ; 



1. Nous parlons de colonnes, car c'est ainsi que nos elements seront disposes a la fin. Mais, pour l'instant, la 
notion de direction horizontale ou verticale n'existe pas encore. 
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II description horizontale du groupe de colonnes 
GroupLayout . SequentialGroup hg = ges . createSequentialGroup () ; 
ges . setHorizontalGroup (hg) ; 
hg.addGroup (collh) ; hg.addGroup (col2h) ; 

// description verticale du groupe de colonnes 
GroupLayout. ParallelGroup hv = ges . createParallelGroup () ; 
ges . setVerticalGroup (hv) ; 
hv.addGroup (collv) ; hv.addGroup(col2v) ; 

} 

private JButton boutons[ ] ; 

} 

public class TestGroupLayout2 
{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 
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Creation de deux groupes de trois boutons 



Remarque 

Ici, les boutons sont alignes suivant les deux directions. Mais, si nous jouons sur la taille 
maximale des boutons (la taille preferentielle n'etant pas utilisee par ce gestionnaire), en 
ajoutant ces instructions : 

for (int i=0 ; KNEOUTONS ; i++) 

boutons[ i] . setMaximumSize (new Dimension30* (i+1) , 10* (i+1))) ; 

nous obtenons alors cette presentation qui montre clairement, cette fois, la seule pre- 
sence de deux groupes verticaux : 
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Informations complementaires 

II est possible de gerer soi-meme la disposition des composants dans un conteneur, de la 
maniere suivante : 

• fournir la reference null a setLayout ; par exemple, pour une fenetre : 

getContentPane ( ) . setLayout (null) ; 

• definir a l'aide de setBounds la taille effective et la position des composants ajoutes au con- 
teneur. 

D' autre part, vous pouvez aussi creer voire propre gestionnaire sous forme d'une classe 
implementant 1' interface LayoutManager. Celle-ci comporte cinq methodes : addLayout- 
Component, removeLayoutComponent, preferredLayoutSize, minimumLayoutSize et layout- 
Container. 
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Textes et graphiques 



Nous avons deja eii l'occasion de dessiner sur un composant en utilisant les methodes draw- 
Line, drawRect ou drawOval de la classe Graphics. Quelquefois, nous avons egalement affi- 
che du texte en utilisant la methode drawString de cette meme classe Graphics. Comme nous 
l'avons deja signale, ces deux types d'operations (dessin et affichage de texte) sont souvent 
regroupees sous le terme de peinture. Pour obtenir la permanence de la peinture sur un com- 
posant, il faut redefinir sa methode paintComponent, laquelle recoit en argument un objet de 
type Graphics dit "contexte graphique". Exceptionnellement, si Ton peut se contenter d'une 
peinture temporaire, il est possible de peindre a la volee en dehors de cette methode. Les 
methodes employees demeurent les memes, moyennant simplement la prise en charge de 
1' allocation et de la liberation du contexte graphique voulu. 

Ce chapitre explore les differentes possibilite de peinture, qu'il s'agisse d'affichage de textes 
ou de dessins. Nous verrons tout d'abord comment modifier la "fonte" employee pour 1' affi- 
chage de textes, ce qui nous amenera a parler du type Font. Nous verrons comment obtenir 
des informations "metriques" relatives a la fonte courante d'un composant, ce qui nous facili- 
tera la disposition de plusieurs textes sur un meme composant. 

Nous examinerons ensuite la creation et l'utilisation d'objets couleur, c'est-a-dire du type 
Color dont nous avons deja employe quelques constantes, telle Color.red. Nous aborderons 
alors les traces de lignes, deja entrevus avec les segments, lignes et ovales, et applicables aux 
rectangles a coins arrondis, lignes brisees, polygones et arcs. Nous verrons egalement com- 
ment la plupart de ces formes peuvent etre peintes. Puis nous etudierons le mode de dessin dit 
"XOR" tres pratique pour superposer plusieurs dessins qui restent simultanement percepti- 
bles. 
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Enfin, nous verrons comment acceder a des images et les afficher, en tenant eventuellement 
compte du temps necessaire a leur chargement en memoire. 

1 Determiner la position du texte 

Jusqu'ici, nous avons utilise la methode drawString en lui fournissant les coordonnees de 
debut d'affichage d'un texte comme dans : 

drawString ("Bonjour", 50, 100) ; 

Mais nous n' avons pas ete tres precis sur ce que representaient ces coordonnees. Par ailleurs, 
nous n' avons jamais affiche plusieurs textes consecutifs sur une meme ligne, ni un texte 
forme de plusieurs lignes consecutives. Pour cela, vous devez disposer d' informations 
supplementaires concernant la police utilisee ainsi que sa taille. A travers deux exemples 
simples, nous allons voir comment y parvenir en recourant a la methode getFontMetrics, que 
nous examinerons ensuite d'une facon plus approfondie. 

1 .1 Deux textes consecutifs sur une meme ligne 

Nous savons que, dans la methode paintComponent d'un composant quelconque (par exem- 
ple un panneau), si g designe son argument, l'appel : 

g . drawString ("Bonjour", 20, 30) ; 

affiche le texte "Bonjour", a partir du point de coordonnees 20, 30. Pour Finstant nous savons 
que 20 correspond a la position horizontale du premier caractere affiche ; nous verrons plus 
tard la signification exacte du 30. 

Si nous souhaitons afficher un autre texte a la suite du precedent, nous savons que la position 
verticale 30 restera la meme. En revanche, nous ne connaissons pas la position horizontale de 
debut de notre nouveau texte, qui est fonction de la longueur occupee par l'affichage prece- 
dent du texte "Bonjour". Pour determiner cette position, vous disposez d'une methode nom- 
inee getFontMetrics : appliquee a un contexte graphique, elle fournit un objet de type 
FontMetrics encapsulant les informations relatives a sa "fonte courante" (police et taille) : 

FontMetrics fin = g. getFontMetrics () ; // fm contient les caracteristiques 

// de la fonte courante employee par le contexte graphique g 
Cet objet dispose, entre autres, d'une methode stringWidth fournissant la longueur en pixels 
d'un texte donne lorsqu'il est affiche avec la fonte courante : 

int lg = fm . stringWidth ("Bonjour") ; // lg contient la longueur (en pixels) 

// du texte "Bonjour" 

Voici un petit programme qui montre comment proceder pour afficher (ici dans un panneau 
occupant toute la fenetre) deux textes consecutifs ("Bonjour", puis " monsieur") sur une 
meme ligne : 
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import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Essai texte") ; 

setSize (300, 150) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 



class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 

int x = 20, y = 30 ; 

String chl = "bonjour" ; 

String ch2 = " monsieur 

g. drawString (chl, x, y) ; 

FontMetrics fm = g . getFontMetrics ( ) 

x += fm. stringWidth (chl) ; 

g. drawString (ch2, x, y) ; 



// e space au debut 



public class PremTxtl 

{ public static void main (String argsf ] 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 




Affichage de deux textes consecutifs sur une meme ligne 

Remarque 

Les caracteres d'une police n'ont pas tous la meme etendue horizontale, a 1' exception des 
polices dites "a espacement fixe". On ne peut done pas determiner la taille exacte d'un 
texte en multipliant sa longueur (nombre de caracteres) par la taille d'un caractere. 
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1 .2 Affichage de deux lignes consecutives 

Ici, nous devons connaitre la distance a prevoir entre deux lignes. Nous pourrions la choisir 
arbitrairement, mais il est preferable de s'appuyer sur une information fournie par la methode 
getHeight de l'objet de type FontMetrics dont nous avons parle, a savoir la hauteur de la fonte 
courante. Celle-ci tient compte d'un necessaire espace (dit interligne) entre les lignes. Bien 
entendu, elle est, cette fois, independante du texte lui-meme. 

Le programme suivant montre comment proceder pour afficher deux textes donnes sur deux 
lignes consecutives : 

import javax. swing.* ; import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Essai texte") ; setSize (300, 150) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 

1 

class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

int x = 20, y = 30 ; 

String chl = "bonjour" ; 

String ch2 = "monsieur" ; 

g. drawString (chl, x, y) ; 

FontMetrics fm = g . getFontMe tries ( ) ; 

y += fm . getHeight ( ) ; 

g. drawString (ch2, x, y) ; 

} 

} 

public class PremTxt2 

( public static void main (String args[ ] ) 

{ MaFenetre fen = new MaFenetre () ; fen. setvisible (true) ; 
} 

} 
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1 .3 Les differentes informations relatives a une fonte 

D'une maniere generale, a un instant donne, un composant dispose d'une "fonte courante". 
En Java, une fonte se definit par : 

• un nom de famille de police 1 (Helvetica, Arial, Times Roman...) ; 

• un style : romain (normal), gras ou italiques ; 

• une taille, exprimee en "points typographiques" (et non en pixels). 

La fonte courante d'un composant est retransmise par le contexte graphique qui lui est asso- 
cie et qu'on recoit en argument de paintComponent. Nous verrons plus loin qu'on peut modi- 
fier la fonte courante et done afficher sur un meme composant des textes dans differentes 
fontes. Dans ce cas, il va de soi qu'il faudra disposer de plus d' informations que dans l'exem- 
ple precedent ou nous nous contentions d'utiliser une seule fonte. 

Voici les differentes informations que peuvent nous fournir les methodes de l'objet de type 
FontMetrics, fourni par la methode getFontMetrics. Celles-ci se referent a la ligne de base du 
texte, au-dessus de laquelle s'ecrivent la plupart des caracteres 2 (a, b, d, d, e, f, h, i, j, k, 1, 
m...). D'autre part, on definit un jambage ascendant qui correspond a la distance entre la 
ligne de base et le haut d'une lettre telle que b, f ou h. De la meme maniere, on definit un jam- 
bage descendant qui correspond a la distance entre la ligne de base et le bas d'une lettre telle 
que g, j ou p. 



Methode 


Resultat fourni 


getAscent 


Jambage ascendant 


getDescent 


Jambage descendant 


getLeading 


Interligne 


getHeight 


Hauteur (distance entre deux lignes de base) 



Les principales methodes de la classe FontMetrics 



Remarque 

La couleur du texte n'est pas definie par la fonte elle-meme, mais par la couleur d'avant- 
plan courante du composant. Celle-ci est retransmise au contexte graphique associe au 

1. Le nom de police (on dit souvent simplement la "police"), quant a lui, correspond a l'association d'un nom 
de famille de police et d'un style. 

2. Elle correspond aux traits figurant sur un "guide-ane" qu'on utilise pour guider une ecriture manuscrite ou 
au trait inferieur d'un cahier d'ecolier. 
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composant. Nous verrons qu'on peut egalement la modifier, au sein du contexte graphi- 
que, a l'aide de la methode setColor. Par exemple, dans notre programme du paragraphe 
1.2, nous pourrions fixer la couleur d'avant-plan du panneau dans le constructeur de la 
fenetre par : 

pan . setForeground (Color. blue) ; // couleur d'avant-plan = bleu 

puis, dans paintComponent, proceder ainsi pour obtenir une premiere ligne bleue et une 
seconde jaune : 

g. drawString (chl, x, y) ; // affichage couleur d' avant-plan courante 
g. setColor (Color .yellow) ; // modification couleur d'avant-plan 



g. drawString (ch2, x, y) ; 

Notez bien que les modifications ainsi operees dans le contexte graphique ne sont pas 
repercutees sur l'objet composant lui-meme. Lors d'un prochain appel de paintCompo- 
nent, la couleur d'avant-plan sera de nouveau le bleu. 




Informations complementaires 



Certaines polices peuvent posseder des caracteres s'etendant au-dela du jambage ascen- 
dant (par exemple I, E, I) ou, plus rarement, du jambage descendant. C'est pourquoi Java 
definit deux informations supplementaires, nominees jambage ascendant maximal et jam- 
bage descendant maximal. On peut les obtenir avec les methodes getMaxAscent et get- 
MaxDescent. 

D'autre part, on peut connaitre ce qu'on nomme Vavance d'un caractere donne, c'est-a- 
dire l'espace horizontal qu'il occupe, avec la methode charWidth, comme dans 
fm.charWidth( 'a '). 



2 Choix de fontes 

Jusqu'ici, nous nous sommes contentes d'afficher du texte sur un composant en employant la 
fonte par defaut. Pour utiliser d'autres fontes, on doit modifier la fonte courante. On y par- 
vient avec la methode setFont, a laquelle on transmet un objet de type Font qu'on cree en 
fournissant a son constructeur les caracteristiques de la fonte souhaitee. 

Ici, Java distingue les fontes logiques des fontes physiques meme si, au bout du compte, il 
s'agit dans les deux cas d'objets de type Font. 

• Les fontes logiques sont definies a partir de noms de famille de polices predefinis et Java 
assure automatiquement la correspondance avec une fonte effectivement installee dans 
l'environnement ; il est ainsi possible d'ecrire des programmes entierement portables, 
meme s'ils n'exploitent pas toutes les possibilites d'une machine donnee. 
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• Les fontes physiques, quant a elles, correspondent a des fontes effectivement installees dans 
une implementation donnee. Nous verrons que, pour vous faciliter les choses, il existe une 
methode permettant de connaitre les fontes physiques disponibles. 

Pour faire d'une fonte donnee/, la fonte courante d'un composant ou d'un contexte graphi- 
que 1 , on emploie la methode setFont a laquelle on fournit en argument l'objet fonte voulu. 

2.1 Les fontes logiques 

Elles sont au nombre de 5, definies par les noms de famille de polices suivants : 

• SansSerif ; 

• Serif ; 

• Monospaced ; 

• Dialog ; 

• Dialoglnput. 

Le style est exprime par l'une des constantes suivantes : 



Norn de constante 


Style 


Font.PLAIN 
Font.BOLD 
Font. ITALIC 

Font.BOLD+Font.lTALIC 


Romain (normal) 

Gras 

Italique 

Gras + italique 



Styles de fontes 



Voici un exemple de construction d'une telle fonte logique : 

Font fl = new Font ("Serif", Font.BOLD+Font.lTALIC, 20) ; 

// famille : "Serif", style : gras+italique, taille : 20 

Voici un exemple de programme qui affiche du texte dans un panneau (dans sa methode 
paintComponeni) en utilisant quelques-unes des possibilites de ces fontes logiques. Le texte 
indique, entre autres, le nom de famille, ainsi que la taille. Nous recourons aux methodes du 
type FontMetrics pour espacer convenablement nos differentes lignes. Notez qu'ici, il n'est 
generalement plus suffisant d'utiliser la hauteur d'une fonte dans la mesure ou deux lignes 



1 . Notez que Ton emploie la meme methode setFont pour un composant ou pour un contexte graphique. II n'en 
va pas de meme pour la couleur courante : on emploie setForeground pour un composant et setColor pour un 
contexte graphique. 
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consecutives emploient des fontes differentes. II est necessaire de determiner entre chaque 
ligne un intervalle forme : 

• du jambage descendant de la premiere fonte ; 

• de Finterligne de la premiere fonte (en fait, on pourrait utiliser egalement celui de la seconde 
ou, mieux, le plus grand des deux) ; 

• du jambage ascendant de la seconde fonte. 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("POLICES LOGIQUES") ; 

setSize (700, 200) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 

} 

class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

String fontest] = { "SansSerif", "Serif", "Monospaced", "Dialog", 
"Dialoglnput"} ; 

int styles[] = { Font. PLAIN, Font. BOLD, Font. ITALIC, Font. PLAIN, 

Font . BOLD+Font . ITALIC} ; 
int failles! ] = {12, 10, 18, 32, 

24} ; 

int x=10, y=10 ; 

for (int i = 0 ; i< fontes . length ; i++) 
{ g.setFont (new Font (fontest i] , styles! i] , taillest i] ) ) ; 
FontMe tries fin = g . getFontMetrics ( ) ; 
String ch = fontest i] + " " + failles! i] 

+ " abcdefghijklmnopqrstuvwxyz0123456789" ; 
y += fm.getAscent () ; 
g. drawString (ch, x, y) ; 
y += fm.getDescent () + fm.getLeading () ; 

} 

} 

} 

public class PolLog 

! public static void main (String argst ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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3 POLICES LOGIQUES 



SansSerif 1 2 abcdefghijklmnopqrstuvwx/z01 23456789 

Suit M iTllllfll^llllllllllll II j IT1TT r'f'T* 



30 



Monospaced 18 at>cdefghijklmnopqrstuvw2cyz0123'156789 

Dialog 32 abcdefghijklmnopqrstuwvxyzOI 23456789 

Dialoglnput 24 abcdefgh±jkJjnn.opqrstuvwxyz0123456789 



0 



Exemple d' utilisation de polices logiques 

* 



Informations complementaires 

La classe Font dispose des methodes suivantes : 

- getFontNamef) fournit le nom de police, c'est-a-dire le nom de famille de police, ac- 
compagne du style (par exemple Arial Italic) ; 

- getFamilyf ) fournit le nom de famille de police (exemple : Arial) ; 

- getName() fournit le nom logique s'il existe, sinon le nom de police. 



2.2 Les fontes physiques 

Une fonte physique se definit a la construction par son nom de police (nom de famille de 
police + style) et sa taille, comme dans : 

Font f = new Font ("Helvetica. Italic", Font. PLAIN, 20) ; 

Notez que le deuxieme argument du constructeur doit toujours etre Font.PLAIN ; cela vient 
du fait que le style est deja fourni dans le nom de police. 

On peut connaitre les fontes disponibles dans une implementation en utilisant la methode 
getAvailableFontFamilyName de la classe GraphicsEnvironment. Elle fournit un tableau de 
chaines contenant les noms des polices disponibles. On obtient un objet de type GraphicsEn- 
vironment, en appelant la methode statique getLocalGraphicsEnvironment. Voici comment 
obtenir les noms de toutes les fontes disponibles dans un tableau de chaines nomme/o«fes : 

String f ontesf ] = GraphicsEnvironment . getLocalGraphicsEnvironment ( ) 
. getAvailableFontFamilyNames () ; 
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Exemple 

Nous vous proposons de realiser un programme qui recherche toutes les polices existantes et 
qui affiche, suivant chaque police et dans une taille 12, le nom ainsi qu'un texte forme de let- 
tres et de chiffres. Etant donne que le nombre de lignes est consequent, nous avons dote le 
panneau utilise pour l'affichage d'une barre de defilement 1 . Pour ce faire, il nous a suffit de 
proceder comme nous avons deja appris a le faire pour une boite de liste (voir paragraphe 5.3 
du chapitre 13). Nous avons cree un "panneau de defilement", c'est-a-dire un objet de type 
JScrollPane, en l'associant au panneau pan : 

defil = new JScrollPane (pan) ; 

Ensuite, nous avons ajoute ce panneau de defilement a la fenetre par : 

getContentPane () . add (defil) ; 
Cependant, les barres de defilement d'un panneau de defilement sont gerees 
automatiquement : elles n'apparaissent que lorsque le composant concerne ne peut etre affi- 
che entierement. Cette decision n'est pas prise en fonction de la taille courante du compo- 
sant, mais en fonction de sa taille preferentielle. Comme cette demiere se trouve etre par 
defaut tres petite (10 x 10 pixels), il est necessaire de la modifier. Ici, nous avons choisi arbi- 
trairement une hauteur de 3 000 pixels. Dans un programme reel, il sera bon de determiner 
cette taille en fonction de la taille exacte de l'information a afficher. 

Voici les quelques instructions necessaires a l'introduction de notre panneau dans un panneau 
de defilement : 

Dimension d = new Dimension (500, 3000) ; 
pan . setPreferredSize (d) ; 
defil = new JScrollPane (pan) ; 
getContentPane () . add (defil) ; 
Voici le programme complet, accompagne d'un exemple d' execution : 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("POLICES EXISTANTES") ; 
setSize (600, 300) ; 
pan = new Paneau ( ) ; 

Dimension d = new Dimension (500, 3000) ; 
pan . setPreferredSize (d) ; 
defil = new JScrollPane (pan) ; 
getContentPane ( ) . add (defil ) ; 

} 

private JPanel pan ; 
private JScrollPane defil ; 

) 



1 . En anglais, scroller. 
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class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 

String f ontesf ] = GraphicsEnvironment . getLocalGraphicsEnvironment ( ) 
. getAvailableFontFamilyNames ( ) ; 

int x=10, y=10 ; 

for (int i = 0 ; i< fontes . length ; i++) 

{ g.setFont (new Font (f ontesf i] , Font. PLAIN, 12)) ; 
FontMetrics fin = g.getFontMetrics () ; 
y += fm.getAscent () ; 

String ch = fontesf i] + " " + "abcdefghijklmnopqrstu™xyz0123456789" ; 

g. drawString (ch, x, y) ; 

y += fm.getDescent () + fm.getLeadingO ; 

} 

} 

} 

public class PolExist 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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\^^~ Remarque 

Si vous reduisez la largeur de la fenetre, vous verrez egalement apparaitre une barre de 
defilement horizontal. 
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3 Les objets couleur 

Les operations de peinture, qu'il s'agisse d'affichage de textes ou de realisation de dessins, 
font toutes appel a la notion de couleur. En Java, une couleur est representee par un objet de 
type Color. 

3.1 Les constantes couleur predefines 

Nous avons deja employe des constantes de la forme Color.red ou Color.yellow. II s'agit 
d'objets constants du type Color, dont voici la liste complete : 



Norn de constante 


Couleur correspondante 


Color.black 


noir 


Color.blue 


bleu 


Color.cyan 


cyan (bleu clair) 


Color.darkGray 


gris fonce 


Color.gray 


gris 


Color.green 


vert 


Color.lightGray 


gris clair 


Color.magenta 


magenta 


Color.orange 


orange 


Color.pink 


rose 


Color.red 


rouge 


Color.white 


blanc 


Color.yellow 


jaune 



Les constantes couleur de la classe Color 




Informations complementaires 



Java fournit, dans la classe SystemColor, d'autres couleurs predefinies correspondant a 
celles utilisees par la plupart des elements des fenetres graphiques de Fenvironnement. 
Citons, par exemple, SystemColor.menuText (couleur des textes des menus), SystemCo- 
lor.controlText (couleur des textes des controles). 

3.2 Construction d'un objet couleur 

On peut construire un objet couleur en fournissant ses trois composantes Rouge, Vert, et Bleu 
(on parle de composantes RVB en francais ou RGB en anglais), sous forme de trois valeurs 
de type byte : 
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Color grisMoyen = new Color (128, 128, 128) ; 

Color grisClair = new Color (220, 220, 220) ; 

Color rougeVif = new Color (255, 0, 0) ; 

Color rougeMoyen = new Color (127, 0, 0) ; 

Precautions 

Attention : la couleur reellement obtenue sur votre ecran dependra de votre systeme. En 
effet, vous obtiendrez la couleur la plus proche compatible avec votre environnement. 
Dans le cas ou seules 16 couleurs sont disponibles, la difference entre la couleur deman- 
ded et celle effectivement obtenue pourra se reveler importante. 

Informations complementaires 

II est possible, a partir d'une couleur donnee c : 

- d'obtenir une meme couleur plus brillante par c.brighterf ) (l'intensite de chaque com- 
posante est multipliee par 1/0.7, tout en etant plafonnee a 255) ; 

- d'obtenir une meme couleur plus sombre par c.darkerf) (Fintensite de chaque compo- 
sante est multipliee par 0,7). 




4 Les traces de lignes 

4.1 Generates 

Dans certains des exemples des chapitres precedents, nous avons ete amenes a utiliser les 
methodes drawLine, drawRect et drawOval de la classe Graphics. D'une maniere generale, 
cette classe dispose de diverses methodes permettant de tracer : 

• des segments de droite ; 

• des rectangles ; 

• des ellipses (appelees ovales par Java) ; 

• des lignes brisees ; 

• des polygones ; 

• des arcs d'ellipse. 

De maniere comparable, d'autres methodes permettent de peindre les surfaces delimitees par 
de telles figures. 

Toutes ces methodes tracent une ligne ou peignent une surface en utilisant la couleur cou- 
rante du contexte graphique correspondant. A l'entree dans la methode paintComponent, il 
s'agit de la couleur d'avant-plan courante du composant (eventuellement modifiee par la 
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methode setFo re ground du composant). On peut bien sur modifier cette couleur dans la 
methode paintComponent en faisant appel a la methode setColor de la classe Graphics. Par 
exemple, si g est un contexte graphique : 

g.setColor (Color. blue) ; //la couleur courante devient le bleu 

Rappelons que la couleur courante d'un contexte graphique n'est pas retransmise au compo- 
sant apres la sortie de la methode paintComponent. 

Toutes ces methodes emploient des coordonnees dont l'origine correspond au coin superieur 
gauche du composant. II est toutefois possible d'effectuer un changement d'origine en utili- 
sant la methode translate de la classe Graphics. Par exemple, si g est un contexte graphique : 

g. translate (50, 20) ; // 1' ancien point de coordonnees (50, 20) 
// devient la nouvelle origine 

4.2 Lignes droites, rectangles et ellipses 

Nous avons deja employe les methodes drawLine, drawRect et drawOval. A simple titre de 
rappel, voici un petit exemple de programme les utilisant : 

import javax. swing.* ; 
import java.awt.* ; 

class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Essais lignes") ; 

setSize (300, 150) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 

} 

class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

g. drawRect (20, 10, 60, 40) ; 

g. drawLine (20, 100, 150, 20) ; 

g. drawOval (130, 60, 110, 50) ; 

} 

} 

public class Lignesl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 



4 - Les traces de lignes 



515 





Essais lignes 


- n|x| 









Exemples de traces de ligne, de rectangle et d 'ovale 

4.3 Rectangles a coins arrondis 

Vous pouvez tracer des rectangles dont les coins sont des quarts d' ellipses, a l'aide de la 
methode drawRoundRect. Elle utilise les memes arguments que drawRect, avec en plus deux 
entiers qui donnent les axes des ellipses servant a former les angles. En voici un exemple. Le 
dernier trace montre que lorsque les axes des ellipses des coins sont egaux aux dimensions du 
rectangle, on obtient... une ellipse. 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Essais coins arrondis") ; 

setSize (350, 100) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 

} 

class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 
int larg = 80, haut = 50 ; 

g. translate (20, 10) ; g . drawRoundRect (0, 0, larg, haut, 10, 10) ; 
g. translate (100, 0) ; g . drawRoundRect (0, 0, larg, haut, 40, 25) ; 
g. translate (100, 0) ; g . drawRoundRect (0, 0, larg, haut, larg, haut) ; 

} 

} 

public class Lignes2 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 
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Exemple de traces de rectangles a coins arrondis 

4.4 Polygones et lignes brisees 

La methode drawPolygon permet de tracer un polygone dont on fournit les coordonnees des 
points, sous forme de deux tableaux d'entiers (un pour les abscisses, un pour les ordonnees), 
ainsi que le nombre de points (cette derniere information permettant de n'utiliser que les pre- 
miers elements d'un tableau). 

La methode drawPolyLine fonctionne de la meme maniere, a cette difference pres qu'elle ne 
joint pas le dernier point au premier. Elle permet done d'obtenir des lignes brisees. 

Voici un exemple : 

import javax. swing.* ; 
import java.awt.* ; 

class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Essais polygones et lignes brisees") ; 

setSize (400, 180) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 

} 

class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

/* trace d' un hexagone * / 
int r = 60 ; 

g. translate (10+r, 10+r) ; 

int x[ ] = new int[ 6] ; int y[ ] = new int[ 6] ; 
for (int i=0 ; i<6 ; i++) 

( x! i] = (int) (r*Math.cos (i*Math.PI/3) ) ; 
y[ i] = (int) (r*Math.sin (i*Math.PI/3) ) ; 

} 

g . drawPolygon (x, y, 6) ; 



4 - Les traces de lignes 



517 



/* trace cF un noeud papillon * / 
g. translate (2*r+20, 0) ; 
x = new int[ 4] ; y = new intt 4] ; 
x[ 0] = y[ 0] = -r ; 
x[ 1] = y[ 1] = r; 
x[ 2] = r ; y[ 2] = 0 ; 
x! 3] = 0 ; y[ 3] = r ; 
g . drawPolygon (x, y, 4) ; 



/* trace d une ligne brisee * / 
g. translate (r+20, -r) ; 
x = new intt 5] ; y = new intt 5] ; 
xf 0] = y[ 0] = 0 ; 
x[ 1] = r ; y[ 1] = 0 ; 
xE 2] = r ; y[ 2] = 2*r ; 
x[ 3] = r/2 ; y[ 3] = r/2 ; 
x! 4] = 3* r/2 ; y[ 4] = r/2 ; 
g.drawPolyline (x, y, 5) ; 



public class Polys 

{ public static void main (String args[ ] 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 




Exemple de traces de polygenes et d'une ligne brisee 



Informations complementaires 

II existe une classe Polygon qui dispose, entre autres, d'un constructeur sans argument qui 
cree un objet vide, ainsi que d'une methode addPoint (int x, int y) qui ajoute au polygone 
le point de coordonnees (x, y). Par ailleurs, on dispose d'une methode drawPolygon 
acceptant un argument de type Polygon. 
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4.5 Traces d'arcs 

La methode drawArc permet de tracer un arc d'ellipse. Elle utilise les memes arguments que 
drawOval, plus deux entiers correspondant respectivement a Tangle de debut du trace et a la 
dimension angulaire de l'arc (en degres). Ces valeurs peuvent etre negatives. 

Voici un exemple : 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Essais arcs") ; 

setSize (400, 120) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 

} 

class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

int r = 50 ; 

g. translate (10,20) ; 

g.drawArc (0, 0, 2*r, 2*r, 45, 135); 

g. translate (2*r+20, 0) ; 

g.drawArc (0, 0, 2*r, r, 30, 210) ; 

g. translate (2*r+20, 0) ; 

g.drawArc (0, 0, 2*r, r, 45, -210) ; 

} 

} 

public class Arcs 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

) 
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Remarque 

Les mesures d' angles relatives aux arcs d' ellipse sont effectuees en realite sur un cercle, 
avant que le resultat ne soit reporte sur l'ellipse correspondante au moyen d'une "transfor- 
mation affine". Ainsi, seuls les angles multiples de 90° sont conserves. Les autres sont 
d'autant plus modifies que l'ellipse est allongee. 



Informations complementaires 

Toutes les lignes sont tracees avec une epaisseur de 1 pixel. Pour obtenir des lignes plus 
epaisses, on peut recourir a la classe Graphics2D, dont nous parlerons un peu plus loin. 
On peut aussi tracer soi-meme plusieurs traits avec un decalage de 1 pixel. 



5 Remplissage de formes 

Les methodes precedentes permettent de dessiner des lignes. La classe Graphics fournit ega- 
lement des methodes permettant de peindre une surface definie par son contour : rectangle, 
polygone, ellipse, arc. Par exemple, on peut peindre un rectangle avec la methode fillRect qui 
utilise les memes arguments que drawRect. D'une maniere generate, toutes ces methodes se 
nommenl fillXXXX et elles prennent les memes arguments que la methode de trace correspon- 
dante, drawXXXX. 

La encore, ces methodes utilisent la couleur courante du contexte graphique correspondant. 
Notez qu'il s'agit de la meme couleur que celle utilisee pour les traces de lignes (et les affi- 
chages de textes). 

La seule difficulte dans l'utilisation de ces methodes reside dans le fait que la partie peinte 
menage une bordure de 1 pixel sur l'un des bords de la forme (et non sur l'ensemble). Gene- 
ralement, ceci n'a guere de consequence lorsqu'on ne cherche pas a entourer la forme d'un 
trait de couleur differente. Dans le cas contraire, on peut toujours contourner le probleme en 
tracant la forme avant le trait. C'est ainsi que nous procederons ici. 

Voici un exemple qui illustre quelques-unes de ces possibilites. 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("Remplissage de formes") ; setsize (550, 180) ; 
pan = new Paneau ( ) ; 
getContentPane ( ) . add (pan) ; 

} 

private JPanel pan ; 

} 
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class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 
int larg = 80, haut = 50 ; 

/* rectangle a coins arrondis de couleur jaune, de bordure noire */ 
g. translate (20, 10) ; 
g.setColor (Color .yellow) ; 

g.fillRoundRect (0, 0, larg, haut, 10, 10) ; // la forme d' abord 
g.setColor (Color .black) ; 

g . drawRoundRect (0, 0, larg, haut, 10, 10) ; // la bordure ensuite 

/* noeud papillon rose a bordure verte */ 
int r = 60 ; int xl ] = new int[ 4] ; int y[ ] = new int[ 4] ; 
g. translate (larg+r+20, r) ; 
x = new int[ 4] ; y = new int[ 4] ; 
x! 0] = i( 0] = -r ; xl 1] = y[ 1] = r; 
x[ 2] = r ; y[ 2] = 0 ; x[ 3] = 0 ; y[ 3] = r ; 
g.setColor (Color. pink) ; g.fillPolygon (x, y, 4) ; 
g.setColor (Color .green) ; g . drawPolygon (x, y, 4) ; 

/* arc gris a bordure rouge * / 
g. translate (r+20, -r) ; 

g.setColor (Color. gray) ; g.fillArc (0, 0, 2*r, 2*r, 45, 135); 
g.setColor (Color. red) ; g.drawArc (0, 0, 2*r, 2*r, 45, 135); 

/* arc j aune a bordure rouge plus grande * / 
g. translate (2*r+20, 0) ; 

g.setColor (Color .yellow) ; g.fillArc (0, 0, 2*r, 2*r, 45, 135); 
g.setColor (Color. red) ; g.drawArc (0, 0, 2*r, 2*r, 45, 210); 

} 

} 

public class Formesl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Informations complementaires 

Java dispose d'une classe nommee Graphics2D, derivee de Graphics, qui offre des possi- 
bility supplementaires de dessin, en particulier : 

- gestion de l'epaisseur du trait et du motif (traits discontinus) : methode setStroke et ob- 
jet de type BasicStroke ; 

- distinction entre coordonnees utilisateur et coordonnees physiques (en pixels) : metho- 
de scale ; 

- gestion de transformations geometriques ; 

- traces de courbes de Bezier. 

L'objet recu par paintComponent est en fait de type Graphics2D 1 . Pour exploiter les 
possibilites de la classe Graphics2D, il suffit de proceder ainsi : 

void paintComponent (Graphics g) 
{ Graphics2D g2d = (Graphics2D) g ; 

} 

6 Mode de dessin 

Jusqu'ici, la realisation d'un dessin sur un composant venait ecraser ce qui se trouvait en des- 
sous. Par exemple, si nous dessinions deux rectangles de couleurs differentes et se chevau- 
chant, seul le second apparaissait en entier. On avait affaire au mode de dessin par defaut. 

Java dispose d'un autre mode de dessin qui permet de superposer deux formes qui restent 
visibles dans leur integralite, moyennant une modification de la couleur de leur partie com- 
mune. La principale difficulte de l'utilisation d'un tel mode nomme mode de dessin XOR 2 
reside dans le fait qu'il est defini par un parametre de couleur que vous devez fournir au 
moment de son choix : 

Color coulBase ; 

setXORMode (coulBase) ; // choix du mode XOR, fonde sur la couleur coulBase 
En general, on utilise comme argument de setXORMode la couleur de fond du composant. 
Dans ce cas : 

• l'affichage sur une zone ayant la couleur de fond est fait avec la couleur courante ; 

• l'affichage sur une zone ayant la couleur courante est fait avec la couleur de fond ; 

1. Mais, attention, son en-tete mentionne le type Graphics. 

2. XOR est l'abreviation de exclusive OR (ou exclusif) ; ce temie est lie a l'operation binaire effectuee sur les 
composantes des couleurs concernees. 
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• Faffichage sur une zone ayant une couleur differente de celle du fond et de la couleur cou- 
rante est fait dans une couleur differente des deux autres. 

Une propriete interessante de ce mode est que si vous effectuez deux fois de suite le meme 
dessin (sans changer de mode XOR entre-temps et sans rien dessiner d' autre), vous annulez 
l'effet du premier dessin. Cela facilite les operations d' animation graphique en faisant ainsi 
apparaitre un dessin donne pendant un court instant. 

Pour revenir au mode de dessin par defaut, on utilise simplement : 

setPaintMode ( ) 

Voici un exemple de programme dont F experimentation (eventuellement la modification) 
vous permettra de visualiser le role du mode XOR. Deux boutons permettent de choisir la 
couleur de fond d'un panneau (rouge ou bleu) dans lequel nous dessinons dans le mode XOR 
(toujours fonde sur la couleur de fond courante 1 ) : 

• un rectangle orange et un ovale de meme couleur, se chevauchant ; 

• un rectangle jaune et un ovale vert, se chevauchant. 

import javax. swing.* ; 
import java.awt.* ; 
import java.awt. event.* ; 

class MaFenetre extends JFrame implements ActionListener 
{ public MaFenetre () 

{ setTitle ("DESSINS") ; 
setSize (350, 250) ; 

Container contenu = getContentPane ( ) ; 

pan = new Paneau ( ) ; 

contenu . add (pan ) ; 

rouge = new JButton ("Rouge") ; 

contenu. add (rouge, "North") ; 

rouge . addActionListener (this ) ; 

bleu = new JButton ("Bleu") ; 

contenu. add (bleu, "South") ; 

bleu. addActionListener (this) ; 

} 

public void actionPerformed (ActionEvent e) 

{ if (e.getSource () == rouge) pan . setBackground (Color. red) ; 
if (e.getSource () == bleu) pan . setBackground (Color. cyan) ; 

} 

private Paneau pan ; 

private JButton rouge, bleu ; 

) 



1. On l'obtient a l'aide de la methode getBackground de la classe JComponent. 
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class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super. paintComponent (g) ; 

g.setXORMode (getBackgroundO ) ; // mode XOR fonde sur la couleur de fond 

/* rectangle et ovale de meme couleur (orange) se chevauchant */ 
g.setColor (Color. orange) ; 
g.fillRect (10, 30, 150, 100) ; 
g.fillOval (30, 10, 100, 150); 

/* rectangle j aune et ovale vert se chevauchant * / 
g.setColor (Color. yellow) ; 
g.fillRect (170, 30, 150, 100) ; 
g.setColor (Color. green) ; 
g.fillOval (190, 10, 100, 150); 

} 

} 

public class ModeDes 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 




Exemple d 'utilisation du mode de dessin XOR 



Informations complementaires 

D'une maniere generate, si on peint avec une couleur courante cCour sur un emplacement 
de couleur cAct, avec un mode XOR fonde sur la couleur cXOR, la couleur effectivement 
obtenue sera definie par la formule cAct A cCour A cXOR f A designe l'operateur de mani- 
pulation de bits "ou exclusif"). 
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7 Affichage d'images 

Nous avons appris a dessiner dans un conteneur. Mais, nous avons egalement eu l'occasion 
de charger une petite image (dite icone) a partir d'un fichier en employant un objet de type 
Imagelcon. Dans une telle image, on definit individuellement la couleur de chacun des 
pixels ; on parle generalement de bitmap. 

Nous allons voir ici que, malgre son nom, le type Imagelcon permet de gerer des bitmaps de 
taille quelconque. En revanche, nous verrons qu'il existe differentes facons d'acceder a une 
image suivant qu'on souhaite ou non que le programme puisse tenir compte d'un delai de 
chargement. 

7.1 Formats d'images 

De nombreux logiciels du commerce permettent de fabriquer des images bitmaps. Mais il 
existe differents formats de stockage de 1' information correspondante, qui peuvent differer 
notamment : 

• par le nombre de couleurs disponibles ; 

• par la technique eventuellement employee pour compresser 1' information 1 . 
Actuellement, Java sait traiter les formats suivants : 

• GIF (Graphical Interchange Format) : 256 couleurs ; 

• JPEG (Joint Photograhic Expert Group) : plus de 16 millions de couleurs (ce format com- 
presse est plus long a traiter que le precedent). 

7.2 Charger une image et I'afficher 

Jusqu'ici, nous nous sommes contentes de charger une image en utilisant le constructeur de 
la classe Imagelcon. L' affichage de F image etait alors automatiquement assure par Java, sui- 
vant notre demande d'association de l'icone correspondante a un composant. 

Le type Imagelcon peut correspondre a une taille quelconque 2 ; nous pouvons done employer 
la meme demarche pour charger une image quelconque. Nous devrons simplement prendre 
en charge son affichage en recourant a la methode drawlmage de la classe Graphics. 

II existe cependant une autre facon de proceder, qui presente surtout un interet lorsque ce 
chargement risque d'etre un peu long et qu'on souhaite eviter de bloquer le programme pen- 
dant ce temps. En fait, cette demarche se revele indispensable dans le cas d'une applet qui 
charge une image depuis un site distant. 



1. Dans ce cas, 1' information peut se trouver plus ou moins degradee. 

2. Alors que, traditionnellement, le mot icone est plutot reserve a une image de petite taille, par exemple 16x16 
pixels. 
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7.2.1 Chargement d'une image avec attente 

Si Ton accepte que le programme s'interrompe pendant le chargement de l'image, il suffit 
done d'utiliser le constructeur de la classe Imagelcon et de Fafficher a l'aide de la methode 
drawlmage. 

Cependant, cette methode attend un argument de type Image, lequel est independant du type 
Imagelcon. Plus precisement, la classe Imagelcon encapsule une reference a un objet de type 
Image, qu'on peut obtenir a l'aide de la methode getlmage : 



L' affichage dans un contexte graphique g sera alors effectue par : 

g. drawlmage (im, x, y, null) ; 

Les deux entiers x et y precisent les coordonnees du point oil sera place le coin superieur gau- 
che de l'image 1 . 

Notez toutefois 1' existence d'un quatrieme parametre (obligatoire) fixe ici a null. Nous ver- 
rons son interet dans le paragraphe suivant. 



Voici un programme qui remplit une fenetre a l'aide des images contenues dans les fichiers 
rouge.gif, vert.gifet jaune.gif que nous avions employes pour placer des carres colores dans 
une barre d'outils. 

Nous utilisons les methodes getlconHeight et getlconWidth pour connaitre la taille des ima- 
ges. Par souci de simplicite, nous ne determinons ici que la taille de la premiere image et 
nous supposons que les autres sont identiques. 

Par ailleurs, nous prevoyons un espace de 3 pixels (en ligne et en colonne) entre les differen- 
tes images, ce qui permet de bien les visualiser. 

import javax. swing.* ; 
import java.awt.* ; 
class MaFenetre extends JFrame 
{ MaFenetre ( ) 

{ setTitle ("IMAGES") ; 

setSize (300, 100) ; 

pan = new Paneau ( ) ; 

getContentPane ( ) . add (pan) ; 



private JPanel pan ; 

1 



1. D'autres methodes drawlmage permettent de definir la hauteur et la largeur souhaitees, ce qui signifie que 
l'image subit eventuellement la transformation geometrique voulue. 



Imagelcon imlc = new Imagelcon ( . . . ) 
Image im = iml c. get Image () ; 



// chargement de 1' image dans imlc 

// im contient la reference a 

// 1' objet de type Image correspondant 



Exemple 
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class Paneau extends JPanel 
{ public Paneau () 

{ rouge = new Imagelcon ("rouge.gif") ; 

jaune = new Imagelcon ("jaune.gif") ; 

vert = new Imagelcon ("vert.gif") ; 

larglcon = rouge . getlconHeight ( ) ; 

hautlcon = rouge . getlconWidth ( ) ; 

} 

public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 
Dimension taille = getSizeO ; 
int x=0, y=0 ; 
while (y < taille. height) 
{ while (x < taille. width) 

{ g.drawlmage ( rouge. getlmage () , x, y, null) ; x += largIcon+3 ; 
g.drawlmage ( vert . getlmage () , x, y, null) ; x += largIcon+3 ; 
g.drawlmage ( jaune. get Image () , x, y, null) ; x += largIcon+3 ; 

} 

x = 0 ; 

y += hautIcon+3 ; 

} 

} 

private Imagelcon rouge, vert, jaune ; 
private int hautlcon, larglcon ; 



public class Imagesl 

{ public static void main (String args[ ] ) 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

} 

} 
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Lecture et affichage d 'images 

Remarque 

II existe un constructeur de la classe Imagelcon qui recoit un argument de type URL cor- 
respondant a l'adresse URL (Uniform Ressource Locator) d'une image a charger depuis 
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un site distant. A priori destine aux applets, il peut etre utilise dans une application si Ton 
a pris soin d'etablir la connexion voulue avant de la lancer. 

7.2.2 Chargement d'une image sans attente 

Nous venons de voir que le chargement d'une image par le constructeur de Imagelcon inter- 
rompait le programme jusqu'a ce que l'image soit chargee. Bien entendu, ce phenomene 
n'est guere perceptible pour de petites images lues dans un fichier local. Mais il le devient si 
l'image est de taille importante et encore plus si elle est chargee depuis un site distant. 

Si Ton souhaite eviter de bloquer le programme pendant le chargement d'une image, on 
utilisera : 

• la methode getlmage de la classe Toolkit pour charger une image depuis un fichier local ; 

• la methode getlmage de la classe Applet pour charger une image depuis un site distant. 

Contrairement au constructeur de Imagelcon, cette methode getlmage n' attend pas que le 
chargement soit effectue pour rendre la main au programme. 

Dans ce cas, un probleme va se poser si Ton se contente d'afficher cette image comme nous 
l'avons fait precedemment, alors que son chargement n'est peut-etre pas termine (on risque 
de n'en voir qu'une partie !). C'est pourquoi Java a prevu qu'on puisse fournir en quatrieme 
argument de la methode drawlmage la reference a un objet particulier dit observateur (obser- 
ver en anglais) ; en fait, il s'agit simplement d'un objet implementant l'interface Observer 
comportant une methode image Update appelee chaque fois qu'une nouvelle portion de 
l'image est disponible. Vous pouvez definir vous-meme un tel objet mais, en general, il vous 
suffira de savoir que tous les composants implementent l'interface Observer et fournissent 
une methode image Update qui, par defaut, appelle repaint. 

Dans ces conditions, il suffit generalement de fournir this en quatrieme argument de drawl- 
mage pour regler le probleme. 

A titre indicatif, vous trouverez sur le site Web d'accompagnement, sous le nom image2.java, 
le programme precedent modifie dans ce sens . 

Informations complementaires 

Si Ton veut absolument suivre revolution du chargement d'une image, on dispose de plu- 
sieurs possibilites : 

- redefinir la methode imageUpdate dans le composant concerne. On procedera ainsi 
lorsque Ton aura besoin de connaitre les dimensions de l'image (autrement que pour 
son affichage qui, quant a lui, en tient automatiquement compte) ; on les obtiendra par 
les methodes getWidth et getHeight de la classe Image, sachant qu'elles fournissent la 
valeur -1 lorsque l'information n'est pas disponible (l'image n'etant pas entierement 
chargee) ; 

- utiliser un "pisteur de medias" de la classe MediaTracker, qui permet d'attendre que 
l'image soit entierement chargee. 
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Les applets 



Nous l'avons vu ail Chapitre 1, Java permet de developper deux sortes de programmes : les 
applications (autonomes) et les applets. La vocation d'une applet est d'etre telechargee sur 
une machine donnee a partir d'une machine distante qui en fournit le code. Ce chargement 
est toujours provoque par l'analyse d'un fichier contenant des commandes HTML (Hyper- 
Text Markup Language). 

Tout ce qui a ete dit jusqu'ici pourra etre employe dans la realisation des applets. II faudra 
simplement tenir compte de quelques particularites inherentes a la maniere dont une applet 
est lancee, ainsi que d'eventuelles restrictions d'acces. 

Nous commencerons par vous presenter 1' applet la plus simple qu'on puisse creer et le fichier 
HTML minimal necessaire a son execution. Puis, nous parlerons de la methode init qui est a 
1' applet ce que main est a 1' application. Nous verrons qu'il existe egalement d'autres metho- 
des propres a une applet (start, stop et destroy), liees aux differents stades de la vie d'une 
applet. Nous vous montrerons comment transmettre des informations depuis le fichier HTML 
a 1' applet. Ensuite, nous donnerons quelques indications sur les restrictions securitaires qui 
peuvent etre imposees aux applets. Enfin, nous fournirons quelques indications concernant la 
transformation d'une application graphique en une applet et nous vous en fournirons un 
exemple. 

1 Premiere applet 

Une applet a beaucoup de points communs avec une application qui cree une fenetre graphi- 
que. Toutes les possibilites etudiees precedemment s'appliquent a une applet. Neanmoins, il 
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existe quelques differences qui sont essentiellement dues a la maniere dont le code corres- 
pondant est lance, ainsi qu'a la communication d'information qui s'etablit entre le fichier 
HTML et le code de 1' applet. 

En effet, une applet est obligatoirement constitute d'une classe derivee de JApplet, laquelle 
est un conteneur de plus haut niveau (comme le sont JFrame ou JDialog). Au lancement 
d'une applet, on dispose automatiquement d'une fenetre graphique, ce qui n'est pas le cas 
avec une application. D' autre part, les dimensions initiales de cette fenetre sont definies par 
des commandes du fichier HTML lancant F applet, et non par le code de F applet lui-meme (la 
taille d'un objet de type JFrame ou derive est generalement fixee dans son constructeur). 

Un fichier HTML est forme de commandes 1 qui decrivent le contenu d'une page web : textes, 
graphiques, liens hypertexte et, eventuellement, applets. Un fichier HTML qui lance une 
applet contiendra une commande particuliere fournissant au minimum les informations sui- 
vantes (la casse des noms de parametres - c'est-a-dire Futilisation de majuscules ou de 
minuscules - n'est pas significative) : 



Nom de parametre 


Infos devant I'accompagner 


C0DE= 


Nom du fichier (.class) contenant les bytecodes de I'applet ; par 
exemple : 

CODE = "PremApp.class" 


WIDTH= 


Largeur initiale de la fenetre consacree a I'applet, par exemple : 
WIDTH=350 


HEIGHT= 


Hauteur initiale de la fenetre consacree a I'applet, par exemple : 
HEIGHT=100 



Les parametres indispensables au lancement d'une applet 



Voici I'applet la plus simple qu'on puisse creer (le corps de la classe correspondante est 
vide !) : 

import javax. swing.* ; 

public class PremApp extends JApplet 

{ public PremApp () 

{ 

} 

} 

Code source d'une applet tres simple 



1. On parle aussi de balises, bien que ce terme soit plutot reserve aux mots-cles utilises dans les commandes. 
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Apres compilation, nous pouvons executer le code correspondant. Nous reviendrons plus en 
detail sur la facon de proceder. Pour 1' instant, sachez simplement que cela peut se faire de 
deux facons : depuis un navigateur ou depuis un logiciel dit "visualisateur d'applets". 

Ici, nous supposons que nous utilisons la seconde demarche, avec un fichier HTML conte- 
nant les parametres WITH=350 et HEIGHT=100. Nous obtenons Faffichage d'une fenetre 
qui se presente ainsi : 



Applet Viewer : PrernApp. class HHd 



Applet 




Execution de I 'applet precedente 



Notez la presence d'une fenetre de titre Applet Viewer : PremApp. class. Elle est creee par le 
visualisateur d'applets. II en va de meme des mentions Applet et Applet started. La derniere 
ligne permet precisement de suivre le deroulement de 1' applet. Le reste (en gris clair) corres- 
pond a la fenetre de dimensions 350 x 100, creee automatiquement pour l'applet en fonction 
des commandes HTML. 



2 Lancement d'une applet 

2.1 Generalites 

Nous avons vu comment lancer une application, qu'elle soit a interface console ou a interface 
graphique. Dans ce dernier cas, elle dispose alors d'une fenetre console. 

Les applets, par nature, sont destinees a etres lancees dans une page web, par un navigateur 
qui exploite alors le fichier HTML correspondant. Ce dernier contient, entre autres, la refe- 
rence au fichier contenant les byte codes de l'applet a lancer (parametre CODE), lesquels 
peuvent se trouver sur une machine distante. Cela l'amene a creer automatiquement dans la 
page web une fenetre de la taille requise (parametres WIDTH et HEIGHT). Une applet res- 
semble done a une application a interface graphique, mais elle ne cree pas de fenetre console. 

Cependant, pour faciliter la tache de mise au point d'une applet, tous les environnements dis- 
posent (ou peuvent disposer) d'un logiciel dit "visualisateur d'applets". II permet d'executer 
une applet, sans qu'il soit necessaire de se connecter au web. Quel que soit son mode d'utili- 
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sation (commande ou outil de developpement integre), il requiert le nom d'un fichier HTML 
analogue a celui utilise par un navigateur. Bien entendu, le code source de F applet doit avoir 
ete prealablement compile sur la machine locale. Outre sa simplicite d'utilisation, ce visuali- 
sateur d' applets permet de disposer d'une interface console, bien agreable pour afficher quel- 
ques messages de suivi de F execution en phase de mise au point. 

2.2 Fichier HTML de lancement d'une applet 

Les commandes HTML peuvent varier suivant le navigateur ou le visualisateur d' applets uti- 
lise. Neanmoins, les principes restent les memes dans tous les cas. En particulier, on y trou- 
vera une commande specifique de lancement de F applet, reperee par le mot-cle APPLET (ou 
OBJECT ou encore EMBED suivant les versions de navigateur ou de visualisateur) et conte- 
nant les informations dont nous avons deja parle (CODE, HEIGHT et WIDTH). 

Nous vous proposons ici une version d'un fichier HTML reduit a son strict minimum qui per- 
met de lancer une applet (il figure sur le site Web d'accompagnement, sous le nom Prem- 
App.html). Nous y avons introduit des commentaires (en italique) qui ne doivent surtout pas 
figurer dans le fichier reel. Les indentations employees ici sont facultatives ; elles facilitent la 
reconnaissance de la structure du fichier. Notez que les mots-cles peuvent indifferemment 
etre ecrits en majuscules ou en minuscules. 



<HTMI> 
<BODY> 
<APPLET 
CODE = 
WIDTH 
HEIGHT 

> 

</APPLET> 
</BODY> 
</HTMI> 



" PremApp . clas s " 
= 350 
= 100 



debut fichier HTML 
debut corps 1 

commande applet 
parametre CODE 
parametre WIDTH 
parametre HEIGHT 

fin commande applet 
fin corps 
fin fichier HTML 



Exemple de fichier HTML minimal (PremApp. html) 

Le fichier dont le nom figure a la suite de CODE= est recherche dans le repertoire courant. II 
s'agit : 

• du repertoire courant local si F applet est executee depuis un visualisateur d' applets ; 

• du repertoire correspondant a Fadresse URL a partir de laquelle a ete charge le fichier 
HTML, dans le cas oil Fon emploie un navigateur. 



1 . Ici, le fichier est reduit a son "corps". Mais ce dernier pourrait etre precede d'un en-tete delimits: par <HEAD> 
et </HEAD>. 
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Remarques 

1 En general, le visualisateur d' applets n'accepte pas toutes les commandes HTML (ou plu- 
tot, il les ignore). Par exemple, la commande TITLE destinee a fournir un titre a une page 
web sera generalement inoperante. 

2 La casse (majuscules/minuscules) n'a aucune importance dans les commandes HTML. 
Par exemple, vous pouvez indifferemment utiliser Applet, applet ou ApplET. 

3 N'oubliez pas la commande </APPLET> qui termine la commande introduite par 

<APPLET >, meme si elle parait redondante ici. Nous verrons plus loin que 

d'autres commandes peuvent apparaitre entre les deux (notamment <PARAM = ....>, 
suivant ce schema (dans lequel nous avons employe une disposition differente) : 

<APPLET CODE = "Infos . class" WIDTH = 250 HEIGHT = 100 > 

autres commandes relatives a 1' applet 

</APPLET> 

4 On peut rechercher une applet dans un repertoire autre que le repertoire courant en uti- 
lisant le parametre CODEBASE=. 

5 La taille d'une applet est modifiable lorsqu'elle est lancee par un visualisateur d' applet, 
mais pas lorsqu'elle est lancee par un navigateur. 

3 La methode init 

3.1 Generates 

Notre precedente applet ne faisait que creer un conteneur vide (de type JApplet). Mais il va 
de soi qu'on pourrait associer a ce conteneur des ecouteurs d'evenements et y introduire des 
composants, a l'instar d'un conteneur de type JFrame ou JDialog. 

Nous procederons de la meme maniere avec un conteneur de type JApplet (ou derive), en 
nous referant la encore, non au conteneur lui-meme, mais a son contenu, obtenu par getCon- 
tentPane. Son gestionnaire par defaut est de type BorderLayout. 

Cependant, un element nouveau intervient avec les applets : 



La methode init d'une applet est executee automatiquement lors du Ian- 
cement de I'applet. 



Or, nous pouvons aussi doter notre classe applet d'un constructeur sans argument, lequel sera 
lui aussi execute (automatiquement) pour construire l'objet correspondant. 

Dans ces conditions, beaucoup d'operations (creation de composants, d' ecouteurs...) peuvent 
se faire soit dans le constructeur, soit dans la methode init. II est d' usage de les placer dans la 
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methode init ; c'est ce que nous ferons. Nous verrons que cette demarche peut se reveler 
indispensable pour certaines operations telles que la recuperation au sein de 1' applet d' infor- 
mations en provenance du fichier HTML ; dans ces conditions, plutot que de placer du code 
d' initialisation en deux endroits, il est preferable qu'il soit regroupe dans la methode init. 



3.2 Exemple 

Voici un exemple d' applet qui cree : 

• un panneau qu'on ajoute au contenu, sans parametre : il est done place dans la zone "centra- 
le" du conteneur (n'oubliez pas que le gestionnaire par defaut de JApplet est de type 
BorderLayoui) ; 

• un second panneau qu'on place en bas (parametre "South") et dans lequel on incorpore deux 
boutons permettant d'agir sur la couleur du panneau superieur. 

II est precede du fichier HTML necessaire au lancement de l'applet, et accompagne d'un 
exemple d'execution obtenu avec un visualisateur d'applets. 



<HTML> 
<BODY> 
<APPLET 

CODE = "App2Bout. Class" 
WIDTH = 250 
HEIGHT = 100 

> 

</APPLET> 
</EODY> 
</HTML> 

import java.awt.* ; 
import java.awt. event.* ; 
import javax. swing. event.* ; 
import javax. swing.* ; 

public class App2Bout extends JApplet implements ActionListener 
{ public void init () 
{ pan = new JPanel ( ) ; 

panCom = new JPanel ( ) ; 

Container contenu = getContentPane ( ) ; 

contenu. add (pan) ; 

contenu . add (panCom, "South") ; 

rouge = new JButton ("rouge") ; 

jaune = new JButton ("jaune") ; 

rouge . addActionListener (this ) ; 

j aune . addActionListener (this ) ; 

panCom. add (rouge) ; 

panCom. add (jaune) ; 

} 
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public void actionPer formed (ActionEvent e) 

{ if (e.getSource () == rouge) pan . setBackground (Color. red) ; 
if (e.getSource () == jaune) pan . setBackground (Color .yellow) 

} 

private JPanel pan, panCom ; 
private JButton rouge, jaune ; 



Applet Viewer: A... HlfiU 



Applet 



rouge 



jaune 



Applet started. 



Exemple d' exploitation de la methode init 



4 Differents stades de la vie d'une applet 

Nous venons de voir que la methode init se trouve appelee apres creation de l'objet applet. 
De meme, il existe une methode nommee destroy qui se trouve appelee au moment oil 1' exe- 
cution de F applet se termine, c'est-a-dire : 

• lorsque Futilisateur quitte le navigateur si l'applet a ete lancee ainsi ; 

• en fermant la fenetre correspondante (ou eventuellement en fermant la fenetre console as- 
sociee) lorsque l'applet a ete lancee depuis un visualisateur d' applets. 

En general, il n'est pas necessaire de redefinir la methode destroy. 

Par ailleurs, apres qu'une applet ait ete lancee, la fenetre correspondante peut se trouver tem- 
porairement fermee ou simplement inactive parce que Futilisateur a fait defiler la page Web 
correspondante. II arrivera que Ton ait besoin dans le code d'etre prevenu de cette particula- 
rite. Ce sera par exemple le cas si l'applet affiche une information ou un dessin evolutif : 
Futilisateur preferera alors generalement que cette evolution cesse pendant qu'il ne voit plus 
l'applet. C'est pourquoi Java prevoit que la methode stop soit appelee chaque fois que 
l'applet n'est plus visible. 

De la meme maniere, Java appelle une autre methode, nommee start, chaque fois que l'applet 
redevient visible. Cette methode est egalement appelee apres l'appel de init suivant le lance- 
ment de l'applet. 
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Voici les differentes methodes concernees par la vie d'une applet : 



Methode 


Appel 


init 


Apres la creation de I'objet applet 


start 


Apres init, puis chaque fois que I'applet redevient visible 


stop 


Chaque fois que I'applet n'est plus visible, ainsi que avant destroy 


destroy 


A la fin de I'execution de I'applet 



Les methodes specifiques a une applet 



Notez qu'on dit souvent que stop est appelee a F arret de I'applet et que start est appelee a 
chaque (re)demarrage. En fait, c'est en redefinissant ces methodes que le programmeur peut 
arreter et reactiver le fonctionnement de I'applet. 

Exemple 

Voici un petit exemple de programme qui met en evidence les appels de ces differentes 
methodes, en affichant un message en fenetre console : 

<HTML> 
<BODY> 
<APPLET 

CODE = "Etats. class" 
WIDTH = 350 
HEIGHT = 100 

> 

</APPLET> 
</EODY> 
</HTML> 

public class Etats extends JApplet 
{ public Etats () 

{ System. out. println ("Construction") ; 

} 

public void init () 

{ System. out. println ("Appel init") ; 
} 

public void start () 

{ System. out. println ("Appel start") ; 
} 

public void stop () 

{ System. out. println ("Appel stop") ; 
} 
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public void destroy () 
{ System. out. println ("Appel destroy") ; 
} 

} 

Construction 
Appel init 
Appel start 
Appel stop 
Appel start 
Appel stop 
Appel start 
Appel stop 
Appel destroy 

Les differents stades de la vie d'une applet 

5 Transmission d'informations a une applet 

On a vu au paragraphe 8 du chapitre 9 comment passer des informations a une application 
(graphique ou console) par le biais de la ligne de commande. D'une maniere comparable, on 
peut transmettre des informations a une applet par le biais de commandes appropriees figu- 
rant dans le fichier HTML. Chaque information est identifiee par un nom et une valeur, 
comme dans (la virgule est facultative) : 

<PARAM NAME="mois", VALDE="mars"> 

Ici, on attribue au parametre de nom mois, la valeur mars. Les noms et les valeurs sont tou- 
jours des chaines de caracteres. La casse des noms de parametres est sans effet 1 ; les com- 
mandes suivantes sont equivalentes a la precedente : 

<PARAM NAME="mois", VALUE="mars"> 
<PARAM NAME="mOIS", VALUE="mars"> 

Ces differentes commandes <PARAM ...> figureront a l'interieur des commandes 
<APPLET> et </APPLET> (ou des commandes equivalentes, suivant le navigateur 
employe). 

Les valeurs de ces informations pourront etre recuperees dans la methode init a l'aide de la 
methode getParameter de la classe J Applet. Par exemple, avec ces instructions : 

public void init ( ) 
{ 

String nomMois = getParameter ("mois") ; 



} 



1. En revanche, la casse reste significative dans les constantes chaines fournies comme valeurs des parametres. 
Ainsi, NAME= "Mois" ne serait pas equivalent a NAME= "mois". 
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on obtiendra la chaine mars dans nomMois si 1' applet a ete lancee avec la commande 
<PARAM...> precedente. 

Voici un petit programme illustrant cette possibility. Au passage, il montre comment exploi- 
ter une valeur numerique (obligatoirement transmise sous forme de chaine). 



<HTML> 
<EODY> 

<APPLET CODE = "Infos . class" WIDTH = 250 HEIGHT = 100 > 
<PARAM NAME = "mois", VALUE = "mars"> 
<PARAM NAME = "annee", VALUE = "2000"> 
</APPLET> 
</EODY> 
</HTML> 

import javax. swing.* ; 

public class Infos extends JApplet 

{ public void init () 

{ String nomMois = getParameter ("mois") ; 

String nomAnnee = getParameter ("annee") ; 

int annee, anneeSuiv ; 

System. out .println ("Mois = " + nomMois) ; 
System. out .println ("Annee = " + nomAnnee) ; 
annee = Integer. parselnt (nomAnnee) ; 
anneeSuiv = annee+1 ; 

System. out .println ("Annee suivante = " + anneeSuiv) ; 

} 

} 

Mois = mars 

Annee = 2000 

Annee suivante = 2001 



Exemple de transmission d' informations dufichier HTML a I 'applet 

Remarques 

1 Les informations fournies par la commande <PARAM...> sont en fait disponibles dans 
n'importe quelle methode, des lors que la methode init a ete appelee. En revanche, elles 
ne sont pas encore disponibles dans le constructeur. 

2 Les valeurs fournies par les parametres WIDTH et HEIGHT sont recuperables de la 
meme maniere que celles fournies par PARAM. Ainsi, dans 1' applet precedente, vous 
pourriez recuperer sa largeur par : 

int larg ; 

String chLarg = getParameter ("width") ; 
larg = Integer .parselnt (chLarg) ; 
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6 Restrictions imposees aux applets 

Les applets ont ete con£ues a l'origine pour etre executees sur un site distant de celui qui en 
fournit le code. Dans ces conditions, les concepteurs de Java avaient prevu des restrictions 
necessaires pour assurer une securite absolue sur la machine d' execution. En particulier, la 
machine virtuelle 1 interdisait a une applet : 

• d'acceder aux fichiers locaux ; 

• de lancer un programme executable local ; 

• d'obtenir des informations relatives au systeme local (autres que des informations banales 
telles que : version de Java utilisee, caracteres de fin de ligne...). 

Toute tentative d' operation de ce type provoquait une exception Security Exception. Qui plus 
est, si une applet ouvrait une fenetre independante (par exemple de type JFrame), Java affi- 
chait un message d'avertissement, afin que l'utilisateur reste conscient du fait que, malgre les 
apparences, il continuait de dialoguer avec un programme distant. 

Avec le temps et avec la generalisation de l'utilisation des applets au sein de ce que Ton 
nomme un intranet, ces restrictions sont apparues trop severes. Ajourd'hui, la notion de ges- 
tionnaire de securite permet a un environnement de definir les operations qu'il autorise les 
applets a faire. Par ailleurs, la notion applet certifi.ee permet d'accorder des permissions 
supplementaires a une applet pour laquelle on dispose d'une garantie d'origine determinee. 

7 Transformation d'une application graphique 

en une applet 

Nous avons vu qu'une applet peut exploiter pleinement toutes les possibilites d'interface gra- 
phique que nous avons etudiees jusqu'ici. Aussi, dans certains cas, sera-t-on tente de transfor- 
mer une application existante en une applet, a condition bien sur qu'elle ne soit pas 
concernee par les restrictions securitaires imposees aux applets. Pour cela, il suffit simple- 
ment de tenir compte des legeres differences entre application et applet qui se manifestent 
dans le mecanisme de lancement et de gestion. 

Tout d'abord, il faut supprimer la methode main ou, si on la conserve, tenir compte du fait 
qu'elle ne sera plus appelee lorsque le code sera lance depuis un fichier HTML. 

Par ailleurs, il faut transformer l'objet fenetre de type derive de JFrame cree par l'application 
(en general dans main) en un objet d'une classe derivee de JApplet. En principe, on evitera de 
doter cette classe d'un constructeur ; les actions realisees dans le constructeur de la fenetre 
principale de l'application seront reportees dans la methode init de l'applet. Une exception 



1. On voit ici tout l'interet de l'existence de cette machine virtuelle. Avec une demarche classique, aucun con- 
trole ne serait plus possible lors de l'execution. 
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aura lieu pour les appels a setSize, setBounds et setTitle qui, n'ayant plus de raison d'etre 
pour une applet, devront etre supprimes. 

Exemple 

Voici comment nous avons transforme en applet F application de dessin de formes proposee 
paragraphe 10 du chapitre 15 : 

• transformation de la fenetre principale (FenMenu) en une classe (ApMenuAc) derivee de 
J applet (qu'il faut rendre publique) ; 

• transformation de son constructeur en une methode init ; 

• suppression des instructions setTitle et setBounds ; 

• suppression de la classe ExMenuAc contenant la methode main. 
Voici le resultat ainsi obtenu : 

<HTML> 
<B0DY> 

< APPLET CODE = "ApMenuAc . class" WIDTH=450 HEIGHT=200> 
</APPLET> 
</BODY> 
</HTML> 

import j ava . awt . * ; 
import j ava. awt. event.* ; 
import javax. swing.* ; 
import javax. swing. event.* ; 

public class ApMenuAc extends JApplet implements ActionListener 
{ static public final String} ] nomCouleurs = 

{ "rouge", "vert", "jaune", "bleu"} ; 

static public final Color[ ] couleurs = 

{Color. red, Color. green, Color .yellow, Color. blue} ; 
static public final String} ] nomlcones 

{ "rouge.gif", "vert.gif", "jaune.gif", "bleu.gif"} ; 

public void init() 

{ Container contenu = getContentPane ( ) ; 

/* creation paneau pour les dessins */ 
pan = new Paneau ( ) ; 
contenu . add (pan ) ; 
pan . setBackground (Color . cyan) ; 
int nbCouleurs = nomCouleurs . length ; 

/* creation des actions * / 
actions = new ActionCouleur [ nbCouleurs] ; 
for (int i=0 ; KnbCouleurs ; i++) 

{ actions! i] = new ActionCouleur (nomCouleurs! i] , couleurs} i] , 

nomlcones} i] , pan) ; 

} 
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/* creation barre des menus * / 
barreMenus = new JMenuBar ( ) ; 
setJMenuBar (barreMenus) ; 

/* creation menu Couleur et ses options * / 
couleur = new JMenu ( "Couleur" ) ; couleur . setMnemonic (' C ) ; 
barreMenus. add (couleur) ; 
for (int i=0 ; KnomCouleurs . length ; i++) 
couleur. add (actions[ i] ) ; 

/* creation menu surgissant Couleur et ses options * / 
couleurSurg = new JPopupMenu () ; 
for (int i=0 ; KnomCouleurs . length ; i++) 
couleurSurg. add (actions! i] ) ; 

/* creation menu formes et ses options rectangle et ovale * / 
formes = new JMenu ("Formes") ; formes . setMnemonic (' F ) ; 
barreMenus. add (formes) ; 

rectangle = new JCheckBoxMenuItem ("Rectangle") ; 

formes. add (rectangle) ; 

rectangle . addActionListener (this) ; 

ovale = new JCheckBoxMenuItem ("Ovale") ; 

formes. add (ovale) ; 

ovale. addActionListener (this) ; 

/* affichage menu surgissant sur clic dans fenetre * / 
addMouseListener (new MouseAdapter () 

{ public void mouseReleased (MouseEvent e) 
{ if (e.isPopupTrigger () ) 

couleurSurg. show (e.getComponent () , e.getXO, e.getY(J) ; 

} 

} ) ; 

/* creation menu Dimensions et ses options Hauteur et Largeur * / 
dimensions = new JMenu ("Dimensions") ; dimensions . setMnemonic (' D" ) ; 
barreMenus. add (dimensions) ; 
largeur = new JMenuItem ("Largeur") ; 
dimensions. add (largeur) ; 
largeur .addActionListener (this) ; 
hauteur = new JMenuItem ("Hauteur") ; 
dimensions. add (hauteur) ; 
hauteur .addActionListener (this) ; 

/* creation barre d outils couleurs * / 

/* (avec suppression textes associes et ajout de bulles d' aide */ 
barreCouleurs = new JToolBar () ; 
for (int i=0 ; KnomCouleurs . length ; i++) 
{ JButton boutonCourant = barreCouleurs. add (actions[ i] ) ; 

boutonCourant . setText (null) ; 

boutonCourant . setToolTipText 

( (String) actionst i] . getValue (Action . SHORT_DESCRIPTION) ) ; 

} 

contenu. add (barreCouleurs, "North") ; 
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public void actionPerformed (ActionEvent e) 
{ Ob j ect source = e . getSource ( ) ; 
if (source == largeur) 

{ String ch = JOptionPane . showInputDialog (this, "Largeur") ; 
pan . setLargeur (Integer .parselnt (ch) ) ; 

} 

if (source == hauteur) 

{ String ch = JOptionPane . showInputDialog (this, "Hauteur") ; 
pan . setHauteur (Integer .parselnt (ch) ) ; 

} 

if (source == ovale) pan. setOvale (ovale. isSelectedO ) ; 

if (source == rectangle) pan. setRectangle (rectangle. isSelectedO ) ; 

pan . repaint ( ) ; 

} 

private JMenuBar barreMenus ; 
private JMenu couleur, dimensions, formes ; 
private JMenuItem [ ] itemCouleurs ; 
private JMenuItem largeur, hauteur ; 
private JCheckBoxMenuItem rectangle, ovale ; 
private JPopupMenu couleurSurg ; 
private ActionCouleur [ ] actions ; 
private JToolBar barreCouleurs ; 
private Paneau pan ; 

} 

class Paneau extends JPanel 
{ public void paintComponent (Graphics g) 
{ super .paintComponent (g) ; 

if (ovale) g.drawOval (10, 10, 10+largeur, 10+hauteur) ; 

if (rectangle) g.drawRect (10, 10, 10+largeur, 10+hauteur) ; 

} 

public void setRectangle (boolean trace) { rectangle = trace ; } 

public void setOvale (boolean trace) { ovale = trace ; } 

public void setLargeur (int 1) { largeur = 1 ; } 

public void setHauteur (int h) { hauteur = h ; } 

public void setCouleur (Color c) { setBackground (c) ; } 

private boolean rectangle = false, ovale = false ; 

private int largeur=50, hauteur=50 ; 

} 

class ActionCouleur extends AbstractAction 

{ public ActionCouleur (String nom, Color couleur, String nomlcone, Paneau pan) 
{ putValue (Action. NAME, nom) ; 

putValue (Action. SMALL_ICON, new Imagelcon (nomlcone) ) ; 
putValue (Action . SHORTJDESCRIPTION, "Fond "+nom) ; 
this. couleur = couleur ; 
this .pan = pan ; 

} 

public void actionPerformed (ActionEvent e) 
{ pan . setCouleur (couleur) ; 

pan . repaint ( ) ; 

setEnabled (false) ; 
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if (actionlnactive != null) actionlnactive . setEnabled (true) ; 
actionlnactive = this ; 

} 

private Color couleur ; 
private Paneau pan ; 

static ActionCouleur actionlnactive ; // ne pas oublier static 
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Les flux et les fichiers 



Au cours des precedents chapitres, nous avons affiche des informations dans la fenetre con- 
sole en utilisant la methode System.out.println. En fait, out est ce que Ton nomme un "flux de 
sortie". En Java (comme en C++), la notion de flux est tres generate puisqu'un flux de sortie 
designe n'importe quel "canal" susceptible de recevoir de 1' information sous forme d'une 
suite d' octets. II peut s'agir d'un peripherique d'affichage, comme c'etait le cas pour out, 
mais il peut egalement s'agir d'un fichier ou encore d'une connexion a un site distant, voire 
d'un emplacement en memoire centrale. 

De facon comparable, il existe des flux d' entree, c'est-a-dire des canaux delivrant de 1' infor- 
mation sous forme d'une suite d'octets. La encore, il peut s'agir d'un peripherique de saisie 
(clavier), d'un fichier, d'une connexion ou d'un emplacement en memoire centrale. 

Comme dans la plupart des langages, Java distingue les flux binaires des flux texte. Dans le 
premier cas, l'information est transmise sans modification de la memoire au flux ou du flux a 
la memoire. Dans le second cas, en revanche, l'information subit une transformation, nom- 
inee formatage, de maniere que le flux recoive ou transmette, en definitive, une suite de 
caracteres. Nous avons deja vu que la methode println realise un tel formatage. 

Dans la plupart des langages, on peut acceder a un fichier binaire, soit de facon sequentielle, 
soit de facon directe. Dans le premier cas, on traite les informations (octets) sequentiel- 
lement, c'est-a-dire dans l'ordre ou elles apparaissent (apparaitront) dans le fichier. Dans le 
second cas, on se place directement sur l'information voulue, sans avoir ainsi a consulter ou 
creer celles qui precedent. Ces possibilites se retrouvent en Java qui propose des flux binaires 
permettant soit Faeces sequentiel, soit Faeces direct. Notez que, en Java, un fichier cree a 
Faide d'un flux a acces direct pourra tres bien etre exploite ulterieurement a Faide d'un flux 
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sequentiel 1 . La reciproque est egalement vraie. Nous verrons d'ailleurs que certaines metho- 
des de lecture et d' ecriture sont communes aux deux types de flux : dans le cas de Faeces 
direct, on se contentera simplement de recourir a une methode supplemental agissant sur un 
pointeur de fichier. 

En Java, le nombre de classes intervenant dans la manipulation des flux est important (plus de 
50). En faire une description systematique risquerait de masquer l'essentiel. C'est pourquoi 
nous commencerons par voir comment proceder pour realiser les operations classiques 
suivantes : 

• creation sequentielle d'un fichier binaire ; 

• lecture sequentielle d'un fichier binaire ; 

• acces direct a un fichier binaire ; 

• creation d'un fichier texte ; 

• lecture d'un fichier texte ; 

• connexion entre deux ordinateurs par le biais de "sockets". 

Ce n'est qu'alors, apres avoir etudie les possibilites originales de gestion de fichiers et de 
repertoires offertes par la classe File, que nous vous proposerons une description detaillee des 
principales classes flux. 

1 Creation sequentielle d'un fichier binaire 

1.1 Generates 

Nous vous proposons d'ecrire un programme qui enregistre dans un fichier binaire differents 
nombres entiers (de type inf) fournis par l'utilisateur au moyen du clavier. 

La classe abstraite OutputStream sert de base a toutes les classes relatives a des flux binaires 
de sortie. La classe FileOutputStream, derivee de OutputStream, permet de manipuler un flux 
binaire associe a un fichier en ecriture. L'un de ses constructeurs s'utilise ainsi : 

FileOutputStream f = new FileOutputStream ("entiers.dat") ; 

Cette operation associe l'objet/a un fichier de nom entiers.dat. Si ce fichier n'existe pas, il 
est alors cree (vide). S'il existe deja, son ancien contenu est detruit. On a done affaire a une 
classique operation d'ouverture d'un fichier en ecriture. 

Cependant, les methodes de la classe FileOutputStream sont rudimentaires 2 . En effet, elles 
permettent seulement d'envoyer sur le flux (done d'ecrire dans le fichier) un octet ou un 
tableau d'octets. 



1 . Avec quelques rares langages, tel Fortran, cela n'est pas possible, car la nature de l'acces est, en quelque sor- 
te, inscrite dans le fichier lui-meme. 

2. Ce sont les memes que celles qui sont prevues dans OutputStream. 
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En fait, il existe une classe DataOutputStream 1 qui comporte des methodes plus evoluees et 
qui dispose (entre autres) d'un constructeur recevant en argument un objet de type FileOut- 
putStream. Ainsi, avec : 

DataOutputStream sortie = new DataOutputStream (f) ; 

on cree un objet sortie qui, par l'intermediaire de l'objet /, se trouve associe au fichier 
entiers.dat. 

Bien entendu, les deux instructions (creation FileOutputStream et DataOutputStream) peu- 
vent etre condensees en : 

DataOutputStream sortie = new DataOutputStream 

( new FileOutputStream ("entiers.dat)) ; 

La classe DataOutputStream dispose notamment de methodes permettant d'envoyer sur un 
flux (done ici d'ecrire dans un fichier) une valeur d'un type primitif quelconque. Elles se 
nomment writelnt (pour ini), writeFloat (pour float), et ainsi de suite. Ici, writelnt nous con- 
viendra. 

1 .2 Exemple de programme 

Voici done un programme complet qui lit des nombres entiers au clavier et qui les recopie 
dans un fichier binaire. Ici, par souci de simplicite, nous avons convenu que l'utilisateur four- 
nirait un entier nul a la suite de sa derniere valeur (il n'est pas recopie dans le fichier). 



import java.io.* ; // pour les classes flux 

public class Crsficl 

{ public static void main (String args[ ] ) throws IOException 
{ 

String nomfich ; 
int n ; 

System. out. print ("donnez le nom du fichier a creer : ") ; 
nomfich = Clavier. lireStringO ; 
DataOutputStream sortie = new DataOutputStream 

( new FileOutputStream (nomfich) ) ; 
do { System. out. print ("donnez un entier : ") ; 

n = Clavier. lirelnt () ; 

if (n != 0) 

{ sortie, writelnt (n) 
} 

} 

while (n != 0) ; 
sortie. close () ; 

System . out . println ("*** fin creation fichier ***"); 

} 

} 



1. Attention : cette classe n'est pas derivee de FileOutputStream, mais seulement de OutputStream. Elle pour- 
rait etre employee pour n'importe quel flux binaire et pas seulement pour un flux associe a un fichier. 
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donnez le nom du 


fichier a creer 


donnez un entier 


: 12 


donnez un entier 


: 85 


donnez un entier 


: 55 


donnez un entier 


: 128 


donnez un entier 


: 47 


donnez un entier 


: 0 


*** fin creation 


fichier *** 



: entiers . dat 



Notez 1' instruction : 

sortie. close () ; 

Elle ferme le flux ; il ne sera done plus possible d'y ecrire par la suite. En meme temps, elle 
assure la fermeture du fichier auquel le flux est associe. 

D'autre part, on releve la presence de la clause throws IOException dans l'en-tete main. En 
effet, la methode writelnt (comme toutes les methodes d'ecriture de DataOutputStrream) 
peut declencher une exception (explicite) du type IOException en cas d'erreur d'ecriture. 
Dans ces conditions, comme nous l'avons vu au chapitre 10, celle-ci doit etre soit traitee, soit 
declaree dans throws. 



1 Nous verrons plus loin que Java dispose d'une classe File permettant de manipuler des 
noms de fichiers ou de repertoires. On pourrait fournir en argument du constructeur de 
FileOutputStream un objet de type File a la place d'un objet de type String. 

2 II est possible de doter un flux d'un tampon. II s'agit d'un emplacement memoire qui 
sert a optimiser les echanges avec le flux. Les informations sont d'abord enregistrees 
dans le tampon, et ce n'est que lorsque ce dernier est plein qu'il est "vide" dans le flux. 
Pour doter un flux de type FileOutputStream d'un tampon, on cree un objet de type Buf- 
feredOutputStream en passant le premier en argument de son constructeur. Voici com- 
ment nous pourrions modifier dans ce sens 1' initialisation de la variable sortie du 
programme precedent : 

DataOutputStream sortie = new DataOutputStream 

( new BufferedOutputStream 

( new FileOutputStream (nomfich) ) ) ; 

Lorsqu'un flux est dote d'un tampon, sa fermeture {close) vide tout naturellement le 
tampon dans le flux. On peut aussi provoquer ce vidage a tout moment en recourant a la 
methode flush. 

De plus, depuis Java 5, il existe une nouvelle API nommee nio (pour New IO !) qui 
offre, entre autres choses, des operations optimisees basees sur 1' utilisation des facilites 
natives du systeme d'exploitation. 



Exemple de creation sequentielle d' un fichier binaire d 'entiers 




Remarques 



2 - Liste sequentielle d'un fichier binaire 



549 



2 Liste sequentielle d'un fichier binaire 

2.1 Generates 

Voyons maintenant comment relire sequentiellement un fichier tel que celui cree par le pro- 
gramme du paragraphe 1, afin d'en afficher le contenu a l'ecran. 

Comme on peut s'y attendre, par analogie avec ce qui precede, la classe abstraite InputStream 
sert de base a toute classe relative a des flux binaires d' entree. La classe FilelnputStream, 
derivee de InputStream, permet de manipuler un flux binaire associe a un fichier en lecture. 
L'un de ses constructeurs s'utilise ainsi : 

FilelnputStream f = new FilelnputStream ("entiers.dat") ; 

Cette operation associe l'objet/a un fichier de nom entiers.dat. Si ce fichier n'existe pas, une 
exception FileNotFoundException (derivee de IOException) est declenchee. 

Cependant, les methodes de la classe FilelnputStream sont rudimentaires 1 . En effet, elles per- 
mettent seulement de lire dans un fichier un octet ou un tableau d'octets. Ici encore, il existe 
une classe DatalnputStream 2 qui possede des methodes plus evoluees et qui dispose (entre 
autres) d'un constructeur recevant en argument un objet de type FilelnputStream. Ainsi, 
avec : 

DatalnputStream entree = new DatalnputStream (f) ; 

on cree un objet entree qui, par l'intermediaire de l'objet /, se trouve associe au fichier 
entiers.dat. Ici encore, les deux instructions (creation FilelnputStream et creation 
DatalnputStream) peuvent etre condensees en : 

DatalnputStream entree = new DatalnputStream 

( new FilelnputStream ("entiers.dat")) ; 

Enfin, la classe DatalnputStream dispose de methodes permettant de lire sur un flux (done ici 
dans un fichier) une valeur d'un type primitif quelconque. Elles se nomment readlnt (pour 
int), readFloat (pour float)... Ici, readlnt nous conviendra. 

2.2 Exemple de programme 

Voici un programme complet qui relit un fichier binaire d'entiers du type de ceux crees au 
paragraphe 



import javax. swing.* ; // pour showInputDialog 
import java.io.* ; 



1. Ce sont les memes que celles qui sont prevues dans InputStream. 

2. Attention : cette classe n'est pas derivee de FilelnputStream, mais seulement de InputStream. Elle pourrait 
etre employee pour n'importe quel flux binaire, et pas seulement pour un flux associe a un fichier. 
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public class Lecsficl 

{ public static void main (String args[ ] ) throws IOException 
{ String nomfich ; 
int n = 0 ; 

System. out. print ("donnez le nom du fichier a lister : ") ; 
nomfich = Clavier. lireStringO ; 
DatalnputStream entree = new DatalnputStream 

( new FilelnputStream (nomfich) ) ; 
System. out .println ("valeurs lues dans le fichier " + nomfich + " :") ; 
boolean eof = false ; // sera mis a true par exception EOFile 
while (!eof) 
{ try 

{ n = entree . readlnt () 
} 

catch (EOFException e) 

{ eof = true ; 

} 

if (!eof) System. out .println (n) ; 

} 

entree. close () ; 

System. out .println ("*** fin liste fichier***"); 

} 

} 



donnez le nom du fichier a lister : entiers.dat 

valeurs lues dans le fichier entiers.dat : 

12 

85 

55 

128 

47 

*** fin liste fichier *** 



Exemple de lecture sequentielle d'un fichier binaire d'entiers 

On retrouve dans main la clause throws IOException correspondant aux exceptions de type 
IOException, susceptibles d'etre declenchees par readlnt en cas d'erreur. 

Ici, toutefois, nous avons souhaite pouvoir lire un fichier comportant un nombre quelconque 
d'entiers. C'est pourquoi nous avons utilise le canevas de lecture suivant : 

while (!eof) // a 1' entree eof est false 

{ try 

{ n = entree . readlnt () 
} 

catch (EOFException e) 

{ eof = true ; // il passera a true lors d' une rencontre de fin de fichier 
} 

if (!eof) System. out. println (n) ; 

} 
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En effet, assez curieusement, la fin de fichier apparait en Java comme une exception. Cela 
nous oblige done a creer un bloc try reduit a une seule instruction de lecture, et a detourner 
quelque peu la gestion d' exceptions de son but premier, a savoir gerer des conditions excep- 
tionnelles. 

En outre, il est necessaire d' initialiser artificiellement la variable n lors de sa declaration, afin 
d'eviter que F instruction : 

if (!eof) System. out. println (n) ; 

soit rejetee par le compilateur sous pretexte que n peut ne pas etre initialisee (si une exception 
est declenchee). 

Remarques 

1 Comme nous l'avons deja fait remarquer pour les flux binaires en sortie, Java dispose 
d'une classe File permettant de manipuler des noms de fichiers ou de repertoires. On 
pourrait fournir en argument du constructeur de FilelnputStream un objet de type File a la 
place d'un objet de type String. 

2 A l'instar d'un flux de sortie, un flux d'entree peut etre dote d'un tampon. Pour doter un 
flux de type FilelnputStream d'un tampon, on cree un objet de type Bufferedlnput- 
Stream en passant le premier en argument de son constructeur. Voici comment nous 
pourrions modifier dans ce sens 1' initialisation de la variable entree du programme 
precedent : 

DatalnputStream entree = new DatalnputStream 

( new BufferedlnputStream 

( new FilelnputStream (nomfich) ) ) ; 




Informations complementaires 



Lorsqu'une machine code une valeur en memoire, elle dispose d'un choix concernant 
l'ordre dans lequel elle utilise les differents octets correspondants. Dans la plupart des 
langages, la recopie binaire d'une telle information conserve cet ordre. Dans ces condi- 
tions, un fichier d'entiers 32 bits cree sur une machine donnee peut ne pas etre directe- 
ment lisible sur une autre machine meme si elle utilise le meme codage (en general, e'est 
le cas ; il s'agit du "complement a deux"). Java, quant-a lui, tient compte de F arrange- 
ment utilise par F implementation pour envoyer sur le flux une succession d'octets 
ordonnee toujours suivant le meme ordre 1 . Dans ces conditions, un fichier cree en Java 
sur une machine peut etre convenablement relu par une autre machine employant le 
meme codage. En revanche, il ne pourra pas toujours etre relu sur la meme machine dans 
un autre langage 2 . 



1 . Dit big-endian : les octets de poids fort en premier. 

2. Ce sera le cas si la machine n'utilise pas l'ordre big-endian. 
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3 Acces direct a un fiehier binaire 

3.1 Introduction 

Java permet de realiser Faeces direct a un fiehier binaire. A cet effet, il dispose d'une classe 
specifique RandomAccessFile qui dispose des fonctionnalites des deux classes Datalnput- 
Stream et DataOutputStream 1 , en particulier des methodes readlnt, readFloat, writelnt, wri- 
teFloat... Toutefois, comme la notion d' acces direct n'a de sens que pour un flux connecte a 
un fiehier, les constructeurs de la classe RandomAccesFile requierent tous un fiehier 2 . On y 
precise le nom 3 , ainsi que le mode d'acces ; il s'agit d'une chaine ayant Fune des deux 
valeurs "r" (lecture seule) ou "rw" (lecture et ecriture). Voici un exemple de construction d'un 
tel objet : 

RandomAccesFile entree = new RandomAccessFile ("donnees.dat", "r") ; 
Par ailleurs, la classe RandomAccessFile dispose d'une methode specifique seek permettant 
d'agir sur le "pointeur de fiehier". Ce dernier correspond au rang du prochain octet a lire ou a 
ecrire (le premier octet portant le numero 0). Tant que Fon n'agit pas explicitement sur ce 
pointeur, il se trouve incremente, apres chaque operation, du nombre d' octets lus ou ecrits. 



3.2 Exemple d'acces direct a un fiehier existant 



Voici un programme qui permet d'afficher differents entiers de rang donne d'un fiehier 
binaire d'entiers du type de celui cree au paragraphe 1.2. On convient que Futilisateur four- 
nira un rang egal a 0 pour signaler qu'il a acheve sa consultation : 

import java.io.* ; 
public class Accdir 

{ public static void main (String args[ ] ) throws IOException 
{ String nomfich ; 
int n, num ; 

RandomAccessFile entree ; 

System. out .print ("donnez le nom du fiehier a consulter : ") ; 

nomfich = Clavier. lireStringO ; 

entree = new RandomAccessFile (nomfich, "r") ; 

do 

{ System. out .print ("Numero de 1' entier recherche : ") ; 
num = Clavier. lirelnt () ; 
if (num == 0) break ; 
entree. seek (4* (num-1) ) ; 



1. En fait, la classe DatalnputStream implemente l'interface Datalnput, et la classe DataOutputStream imple- 
mente l'interface DataOutput . 

2. Ce qui n'etait pas le cas pour les classes DataOutputStream ou DatalnputStream. 

3. Nous verrons qu'il existe egalement un constructeur acceptant un argument de type FILE. 
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n = entree . readlnt ( ) ; 

System. out. println (" valeur = " + n) ; 

} 

while (num != 0) ; 
entree . close ( ) ; 

System. out. println ("*** fin consultation fichier ***"); 

} 

} 



donnez le nom du fichier a consulter : entiers . dat 
Numero de 1' entier recherche : 3 

valeur = 55 
Numero de 1' entier recherche : 5 

valeur = 47 
Numero de 1' entier recherche : 2 

valeur = 85 
Numero de 1' entier recherche : 0 
*** fin consultation fichier *** 



Exemple de consultation, en acces direct, d'un fichier binaire existant 
Notez 1' instruction : 

entree. seek (4* (num-1) ) ; 

La formule 4*(num-l ) se justifie par le fait que le premier octet est de rang 0 et que, ici, nous 
avons convenu que, pour l'utilisateur, le premier entier du fichier porterait le numero 1. 

3.3 Les possibilites de I'acces direct 

Outre les possibilites de consultation rapide qu'il procure, I'acces direct facilite et accelere 
les operations de mise a jour d'un fichier. Dans ce cas, on utilise le mode d' acces "rw". 

En theorie, I'acces direct permet de creer un nouveau fichier en introduisant les informations 
dans un ordre quelconque. Ainsi, nous pourrions creer un fichier binaire d'entiers en laissant 
l'utilisateur entrer les entiers dans l'ordre de son choix : il devrait alors, pour chaque entier 
fourni, preciser la place qu'il souhaite qu'il occupe dans le fichier. 

Or, il faut savoir que, dans bon nombre d'environnements, des que vous ecrivez le enieme 
octet d'un fichier, il y a automatiquement reservation de la place de tous les octets 
precedents 1 ; leur contenu, en revanche, doit etre considere comme etant aleatoire. 



1. De toute facon, tous les environnements reservent toujours la place d'un nombre minimal d'octets (corres- 
pondant a la taille du tampon employe), de sorte que le probleme evoque existe toujours, au moins pour certains 
octets du fichier. 
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Dans ces conditions, a partir du moment oil rien n'empeche l'utilisateur de laisser des "trous" 
lors de la creation du fichier, il faudra etre en mesure de reperer ces eventuels trous lors de 
consultations ulterieures du fichier. Plusieurs techniques existent a cet effet : 

• on peut, par exemple, avant d'executer son programme, commencer par initialiser tous les 
emplacements du fichier a une valeur conventionnelle, dont on sait qu'elle ne pourra pas ap- 
paraitre comme valeur effective ; 

• on peut aussi gerer une table des trous, table qui doit alors de preference etre conservee dans 
le fichier lui-meme. 

D'autre part, Faeces direct n'a d'interet que lorsqu'on est en mesure de fournir le rang de 
l'emplacement concerne, ce qui n'est pas toujours possible. Ainsi, si Ton considere ne serait- 
ce qu'un simple fichier de type repertoire telephonique, en general, on recherchera une per- 
sonne par son nom plutot que par son numero d'ordre dans le fichier. Cette contrainte, qui 
semble imposer une recherche sequentielle, peut toutefois etre contournee par la creation de 
ce que Ton nomme un index, e'est-a-dire une table de correspondance entre un nom d'indi- 
vidu et sa position dans le fichier. 

Nous n'en dirons pas plus sur ces methodes specifiques de gestion de fichiers, qui sortent 
manifestement du cadre de cet ouvrage. 

3.4 En cas d'erreur 

3.4.1 Erreur de pointage 

II faut bien voir que le positionnement dans le fichier se fait sur un octet de rang donne et 
non, comme on pourrait le preferer, sur un "bloc" (on parle souvent d'enregistrement) de rang 
donne. D'ailleurs, en Java, cette notion d'enregistrement n'est pas exprimee de maniere 
intrinseque au sein du fichier. Ainsi, dans notre programme precedent, vous pourriez, par 
megarde, utiliser la formule 4*num-l au lieu de 4*(num-l). Celle-ci vous positionnerait sys- 
tematiquement "a cheval" entre le dernier octet d'un entier et le premier octet de l'entier sui- 
vant. Bien entendu, les resultats obtenus seraient quelque peu fantaisistes, mais le programme 
s'executerait quand meme (sauf pour le dernier entier !). 

3.4.2 Positionnement hors fichier 

Lorsqu'on accede ainsi directement a l'information, le risque existe de se positionner en 
dehors du fichier. En fait : 

• S'il recoit une valeur negative, seek lance une exception IOException. Si elle n'est pas trai- 
tee, on obtient le message Negative seek offset. 

• En revanche, aucune exception n'est declenchee par seek si on lui fournit une valeur supe- 
rieure a la taille actuelle du fichier. Mais on obtiendra une exception EOFexception si on 
lance ensuite une operation de lecture. L'ecriture, quant-a elle, est toujours possible (si le 
fichier a ete ouvert dans le mode "rw") puisque e'est precisement comme cela qu'on peut 
creer un nouveau fichier. 
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Dans ces conditions, lorsqu'on consulte un fichier existant en acces direct, le mieux est de se 
proteger explicitement d'un mauvais positionnement : 

• en determinant la taille du fichier a l'aide de la methode length de la classe RandomAcces- 
File (attention, elle fournit un resultat de type long) ; 

• en s'assurant que la valeur fournie a seek est bien non negative et inferieure a cette taille. 
Voici comment nous pouvons modifier dans ce sens l'exemple precedent : 

import java.io.* ; 
public class Accdirl 

{ public static void main (String args[ ] ) throws IOException 
{ String nomfich ; int n, num ; 
RandomAccessFile entree ; 

System . out . print ("donnez le nom du fichier a consul ter : ") ; 

nomfich = Clavier. lireStringO ; 

entree = new RandomAccessFile (nomfich, "r") ; 

long taille = entree . length ( ) ; 

do 

{ System. out. print ("Numero de 1' entier recherche : ") ; 
num = Clavier . lirelnt () ; if (num == 0) break ; 
int rang = 4* (num-1) ; 
if ( (rang>0) SS (rang<taille) ) 
{ entree. seek (rang) ; 
n = entree . readlnt ( ) ; 

System. out. println (" valeur = " + n) ; 

} 

else { System. out. println ("entier inexistant") ; 
continue ; 

} 

} 

while (num != 0) ; 
entree . close ( ) ; 

System. out. println ("*** fin consultation fichier ***"); 

} 

} 



donnez le nom du fichier a consulter : entiers.da 
Numero de 1' entier recherche : 3 

valeur = 55 
Numero de 1' entier recherche : 10 
entier inexistant 
Numero de 1' entier recherche : -5 
entier inexistant 
Numero de 1' entier recherche : 2 

valeur = 85 
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Numero de 1' entier recherche : 0 
*** fin consultation fichier *** 



Consultation en acces direct avec protection contre le positionnement hors fichier 

4 Les flux texte 

4.1 Introduction 

Avec les classes DatalnputStream et DataOutputStream que nous avons etudiees dans les 
precedents paragraphes, vous pouvez lire ou ecrire sur un flux binaire (eventuellement con- 
nects; a un fichier) des informations de n'importe quel type primitif, en particulier des carac- 
teres ou meme des chaines de caracteres. Cependant, dans ce cas, les caracteres etant 
represented en memoire sous forme de deux octets (codage Unicode), ils sont vehicules sous 
cette forme sur le flux (n'oubliez pas que, dans un flux binaire, 1' information ne subit aucune 
transformation). 

Or, dans tous les environnements, on est habitue a manipuler des fichiers dits de type texte 
(ou fichiers texte ou encore fichiers formates). A titre d'image, on peut dire que ce sont des 
fichiers que vous pouvez : 

• creer ou consulter avec un editeur de texte ou un traitement de texte employant le mode 
texte ; 

• lister par une commande de l'environnement, telle que type depuis une fenetre DOS sur PC, 
more ou pr sous Unix (ou Linux). 

Or, dans ces fichiers texte, chaque caractere se trouve code sur un seul octet et suivant un 
code dependant plus ou moins de l'environnement. Generalement, on y trouve un caractere 
ou une suite de caracteres permettant de representer une fin de ligne. A titre indicatif, il s'agit 
du caractere de code hexadecimal 10 sous Unix (note LF) et de la suite des deux caracteres de 
code hexadecimal 13 (note CR) et 10 (LF) dans les environnements PC. 

Par consequent, les fichiers binaires qu'on pourrait creer ou lire a l'aide des classes etudiees 
precedemment ne peuvent pas etre considered comme des fichiers texte, meme s'ils ne con- 
tiennent que des caracteres Unicode. 

C'est pourquoi Java dispose de deux autres families de classes, derivees des classes abstraites 
Printer et Reader, permettant de manipuler des flux texte. Comme on s'y attend, les caracte- 
res ainsi manipules subiront alors une transformation, a savoir : 

• pour un flux en sortie : une conversion de deux octets representant un caractere Unicode en 
un octet correspondant au code local de ce caractere dans 1' implementation ; 

• pour un flux en entree : une conversion d'un octet representant un caractere dans le code lo- 
cal en deux octets correspondant au code Unicode de ce caractere. 
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En outre, les fins de lignes seront transformees en accord avec leur representation locale. 

Mais Java va plus loin puisqu'il offre egalement des possibilites de formatage de F informa- 
tion. A titre de rappel, considerons ces instructions : 

int n ; 

System. out. println ("valeur = " + n) ; 

Pour en permettre l'affichage a l'ecran, la valeur de n (codee dans le type int) subit une trans- 
formation, dite formatage, qui consiste : 

• a la convertir en base 10 ; 

• a en extraire les differents chiffres (0 a 9) ; 

• a associer a chacun de ses chiffres le caractere correspondant, puis a le convertir dans le code 
local de F implementation. 

Ces possibilites de formatage a l'ecran vont se retrouver au niveau d'un flux texte, par le biais 
de la classe PrintWriter dotee, entre autres, des methodes print et println, analogues a celles 
de la classe System.out. De plus, depuis Java 5, cette classe dispose de methodes printfet for- 
mat aux possibilites voisines de la fameuse fonction printfdu langage C. 

En revanche, en ce qui concerne le formatage en entree, nous verrons qu'il est effectivement 
realisable mais que la demarche employee n'est pas symetrique de celle utilisee en sortie. 
Nous retrouverons en fait une dissymetrie comparable a celle que nous avons rencontree 
entre l'affichage a l'ecran et la lecture au clavier. 

4.2 Creation d'un fichier texte 
4.2.1 Generalities 

Nous vous proposons d'ecrire un programme qui lit des nombres entiers au clavier et qui, 
pour chacun d'entre eux, ecrit une ligne d'un fichier texte contenant le nombre fourni accom- 
pagne de son carre, sous la forme suivante : 

12 a pour carrre 144 

On convient que l'utilisateur fournira la valeur 0 pour signaler qu'il n'a plus de valeurs a 
entrer. 

La classe abstraite Writer sert de base a toutes les classes relatives a un flux texte de sortie. La 
classe FileWriter, derivee de Writer, permet de manipuler un flux texte associe a un fichier 1 . 
L'un de ses constructeurs s'utilise ainsi : 

FileWriter f = new FileWriter ("carres.txt") ; 

Cette operation associe l'objet/a un fichier de nom carres.txt 2 . S'il n'existe pas, il est cree 
(vide). S'il existe, son ancien contenu est detruit. On a done affaire a un classique ouverture 
en ecriture. 



1 . Notez que FileWriter derive en fait de OutputStreamWriter qui, quant a elle, s'applique a un flux texte quelconque. 

2. Nous verrons qu'il existe egalement un constructeur acceptant un objet de type FILE. 
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Les methodes de la classe FileWriter permettent d'ecrire des caracteres, des tableaux de 
caracteres ou des chaines. Dans certains cas, elles se reveleront suffisantes. Mais, si Ton sou- 
haite disposer de possibilites de formatage, on peut recourir a la classe PrintWriter qui dis- 
pose d'un constructeur recevant en argument un objet de type FileWriter. Ainsi, avec : 

PrintWriter sortie = new PrintWriter (f) ; 

on cree un objet sortie qui, par l'intermediaire de l'objet/, se trouve associe au fichier car- 
res, txt. Bien entendu, les deux instructions peuvent etre fusionnees en : 

PrintWriter sortie = new PrintWriter (new FileWriter ("carres.txt")) ; 

Comme nous Favons vu dans F introduction, la classe PrintWriter dispose des methodes print 
et println que nous allons pouvoir utiliser exactement comme nous l'aurions fait pour afficher 
1' information voulue a Fecran. 

4.2.2 Exemple 

Voici le programme complet voulu, accompagne des dialogues en fenetre console : 



import j ava . io . * ; 
public class Crftxtl 

{ public static void main (String args[ ] ) throws IOException 
{ String nomfich ; 
int n ; 

System. out .print ("Donnez le nom du fichier a creer : ") ; 
nomfich = Clavier . lireString ( ) ; 

PrintWriter sortie = new PrintWriter (new FileWriter (nomfich) ) ; 
do 

{ System. out. print ("donnez un entier : ") ; 
n = Clavier . lirelnt () ; 
if (n != 0) 

{ sortie .println (n + " a pour carre " + n*n) ; 
} 

} 

while (n != 0) ; 
sortie. close () ; 

System. out. println ("*** fin creation fichier***"); 

} 

} 



Donnez le nom du fichier a creer : carres.txt 
donnez un entier : 5 
donnez un entier : 12 
donnez un entier : 45 
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donnez un entier : 2 
donnez un entier : 0 



Exemple de creation d'unfichier texte 
Voici la liste du fichier ainsi cree : 

5 a pour car re 25 
12 a pour carre 144 
45 a pour carre 2025 
2 a pour carre 4 

Remarques 

1 A l'instar d'un flux binaire de sortie, un flux texte de sortie peut theoriquement etre dote 
d'un tampon. Par exemple, pour doter d'un tampon un flux de type PrintWriter, on cree 
un objet de type BufferedWriter en passant le premier en argument de son constructeur : 

PrintWriter sortie = new PrintWriter 

(new BufferedWriter 
(new FileWriter ("carres.txt"))) ; 

Cependant, la classe PrintWriter dispose deja de son propre tampon, de sorte que cette 
demarche est rarement utile. 

2 Comme on s'y attend, println introduit le caractere ou les caracteres representant une 
fin de ligne dans 1' environnement concerne. On peut connaitre la chaine correspondante 
par : 

String finLigne = System. getProperty ("line. separator") ; 

3 L' objet out est un objet constant appartenant a la classe PrintStream (derivee de Out- 
putStream) et non a PrintWriter comme on pourrait s'y attendre. Cela est essentielle- 
ment lie a l'historique de Java : la classe PrintWriter a ete introduite pour compenser 
certaines lacunes de PrintStream. Dans la pratique, ce point est de peu d'importance. 

4.3 Exemple de lecture d'un fichier texte 

Nous venons de voir comment la classe PrintWriter permet de creer des fichiers texte, et en 
particulier comment les methodes print et println permettent d'y enregistrer des informations 
(formatees) d'un type primitif quelconque. Nous vous proposons maintenant de voir com- 
ment relire de tels fichiers texte. Cependant, cette fois, il n'existe pas de classe symetrique de 
PrintWriter. Nous allons voir comment proceder en distinguant deux situations : 

• On se contente d'acceder aux lignes du fichier (sans chercher a en interpreter le contenu). 

• On souhaite pouvoir acceder aux differentes informations presentes dans une ligne. 
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4.3.1 Acces aux iignes d'un fichier texte 

Nous vous proposons d'ecrire un programme qui relit un fichier texte tel que celui cree par 
l'exemple du paragraphe 4.2 et qui en affiche le contenu a l'ecran. 

Cette fois, il n'existe pas de classe jouant le role symetrique de PrintWriter. II faut se conten- 
ter de la classe FileReader, symetrique de FileWriter 1 . En la couplant avec la classe Buffered- 
Reader qui dispose d'une methode readLine, nous allons pouvoir lire chacune des lignes de 
notre fichier (avec FileReader seule, on ne pourrait acceder qu'a des caracteres, et il nous 
faudrait prendre en charge la gestion de la fin de ligne). Nous creons done un objet entree de 
la facon suivante : 

Buf feredReader entree = new BufferedReader (new FileReader ("carres.txt")) ; 

La methode readLine de la classe BufferedReader fournit une reference a une chaine corres- 
pondant a une ligne du fichier. Si la fin de fichier a ete atteinte avant que la lecture ait com- 
mence, autrement dit si aucun caractere n'est disponible (pas meme une simple fin de ligne), 
readLine fournit la valeur null. II est done possible de parcourir les differentes lignes de notre 
fichier, sans avoir besoin cette fois de recourir a la gestion des exceptions. II suffit d'employer 
un des canevas suivants : 
do 

{ ligne = entree . readLine ( ) ; 

if (ligne != null) { // traitement d'une ligne } 

} 

while (ligne != null) ; 

while (true) 

{ ligne = entree . readLine ( ) ; 
if (ligne != null) break ; 
/ / traitement cf une ligne 

} 

Voici un programme complet de liste de notre fichier : 



import java.io.* ; 
public class Lecftxtl 

{ public static void main (String args[ ] ) throws IOException 
{ 

String nomfich ; 
String ligne ; 

System. out. print ("Donnez le nom du fichier a lister : ") ; 
nomfich = Clavier . lireString () ; 

BufferedReader entree = new BufferedReader (new FileReader (nomfich) ) ; 



1 . Dans le cas ou, comme ici, on cherche a associer un flux a un fichier. S'il s'agissait d'un flux quelconque, on 
utiliserait la classe InputStreamReader dont derive FileReader. 
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do 



{ ligne = entree . readLine ( ) ; 

if (ligne != null) System. out. println (ligne) ; 

} 

while (ligne != null) ; 
entree . close ( ) ; 

System. out. println ("*** fin liste fichier ***"); 



Donnez le nom du fichier a lister : carres.txt 

5 a pour car re 25 

12 a pour carre 144 

45 a pour carre 2025 

2 a pour carre 4 

*** fin liste fichier *** 



Remarque 

Les habitues du C pourront utiliser un schema de ce genre : 

while ( (ligne = entree . readLine () ) != null) 
System. out. println (ligne) ; 

4.3.2 La classe StringTokenizer 

Dans l'exemple precedent, nous nous sommes contentes d'acceder aux differentes lignes du 
fichier. Dans certains cas, vous pourrez avoir besoin d'acceder a chacune des informations 
d'une meme ligne. Nous Favons deja dit, Java ne dispose pas de fonctionnalites de lecture 
formatee analogues a celles d'ecriture formatee que procure la classe PrintWriter. En revan- 
che, il dispose d'une classe utilitaire nommee StringTokenizer, qui permet de decouper une 
chaine en differents tokens (sous-chaines), en se fondant sur la presence de caracteres separa- 
teurs qu'on choisit librement. Par ailleurs, on pourra appliquer a ces differents tokens, les 
possibilites de conversion d'une chaine en un type primitif, ce qui permettra d'obtenir les 
valeurs voulues. 



Supposons que nous disposions d'un fichier texte nomme reels.txt, contenant des nombres 
fiottants repartis d'une maniere quelconque, c'est-a-dire que chaque ligne peut en comporter 
zero, un ou plusieurs, separes les uns des autres par au moins un espace, comme dans cet 
exemple : 

12 4.2 1.5e-3 

4.5 78.4 1.25e2 4.33 -3.5 

-2 

-1 6.2 8.97 



Exemple de liste des lignes d'un fichier texte 




Exemple 1 



-3e-5 
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Nous allons realiser un programme qui effectue l'affichage a Fecran de ces differents nom- 
bres, et qui en calcule la somme. Nous lisons chaque ligne du fichier comme precedemment. 
Puis nous construisons, a partir de la ligne lue (ici, ligneLue), un objet de type 
StringTokenizer : 

StringTokenizer tok = new StringTokenizer (ligneLue, " ") ; 

Le second argument (ici, une chaine formee du caractere espace) indique les differents sepa- 
rateurs utilises. 

Ensuite, nous avons recours aux methodes suivantes de la classe StringTokenizer : 

• countToken, qui compte le nombre de tokens d'un objet du type ; 

• nextToken, qui fournit le token suivant s'il existe. 
Voici le programme complet : 

import java.io.* ; 

import java.util.* ; // pour StringTokenizer 
public class Lectxt3 

{ public static void main (String args[ ] ) throws IOException 
{ String nomfich ; 
double x, som =0. ; 

System. out. print ("donnez le nom du fichier a lister : ") ; 
nomfich = Clavier . lireString () ; 

BufferedReader entree = new Buf feredReader (new FileReader (nomfich) ) ; 

System. out .println ("Flottants contenus dans le fichier " + nomfich + " :") ; 
while (true) 
{ String ligneLue = entree . readLine ( ) ; 
if (ligneLue == null) break ; 
StringTokenizer tok = new StringTokenizer (ligneLue, " ") ; 
int nv = tok . countTokens ( ) ; 
for (int i=0 ; i<nv ; 

{ x = Double . parseDouble (tok. nextToken () ) ; 
som += x ; 

System. out. println (x + " ") ; 

} 

} 

entree. close () ; 

System. out .println ("somme des nombres = " + som) ; 
System. out .println ("*** fin liste fichier***"); 

} 

} 



12.0 
4.2 

0.0015 

4.5 

78.4 
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125.0 

4.33 

-3.5 

-2.0 

-1.0 

6.2 

8.97 

-3.0E-5 

somme des nombres = 237.10146999999998 
*** fin liste fichier *** 



Exemple de decoupage en tokens des lignes d'un fichier texte (1) 

Exemple 2 

A simple titre indicatif, voici comment nous pourrions relire un fichier texte du type de celui 
cree au paragraphe 4.2, et en extraire les differents nombres et leur carres : 

import java.io.* ; 

import java.util.* ; // pour StringTokenizer 
public class Lectxt2 

{ public static void main (String argst ] ) throws IOException 
{ String nomfich ; 
int nombre, carre ; 

System. out. print ("donnez le nom du fichier a lister : ") ; 
nomfich = Clavier. lireStringO ; 

BufferedReader entree = new Buf feredReader (new FileReader (nomfich) ) ; 
System. out. println ("Nombres et carres contenus dans ce fichier") ; 
while (true) 
{ String ligneLue = entree . readLine ( ) ; 
if (ligneLue == null) break ; 
StringTokenizer tok = new StringTokenizer (ligneLue, " ") ; 
nombre = Integer .parselnt (tok.nextToken () ) ; 

for (int i=0 ; i<3 ; i++) tok.nextToken () ; // pour sauter : a pour carre 
carre = Integer .parselnt (tok.nextToken () ) ; 
System. out. println (nombre + " " + carre) ; 

} 

entree . close ( ) ; 

System. out. println ("*** fin liste fichier ***"); 

} 

} 



donnez le nom du fichier a lister : carres.txt 
Nombres et carres contenus dans ce fichier 
5 25 
12 144 
45 2025 
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2 4 

*** fin liste fichier *** 



Exemple de decoupage en tokens des lignes d'un fichier texte (2) 

Remarque 

L'objet in est un objet constant appartenant a la classe InputStream. On peut connecter un 
flux texte au clavier en procedant ainsi : 

InputStreamReader lecteur = new InputStreamReader (System. in) ; 

On pourra ainsi lire des caracteres sur le clavier (octets) et obtenir des caracteres Uni- 
code. On pourra egalement lire des lignes de texte en procedant ainsi : 

BufferedReader entree = new BufferedReader (lecteur) ; 

C'est d'ailleurs ainsi que nous procedons dans la classe Clavier. 

5 La gestion des fichiers : la classe File 

Java dispose d'une classe File qui offre des fonctionnalites de gestion de fichiers comparables 
a celles auxquelles on accede par le biais de commandes systeme de l'environnement. Ici, il 
s'agit d'operations concernant le fichier dans sa globalite, et non plus chacune des informa- 
tions qu'il contient. C'est ainsi que Ton pourra creer, supprimer ou renommer un fichier ou 
un repertoire, tester l'existence d'un fichier ou d'un repertoire, obtenir des informations rela- 
tives aux protections ou aux dates de modification, lister les noms de fichiers d'un repe- 
rtoire... C'est ce que nous vous proposons d' examiner ici. 

5.1 Creation d'un objet de type File 

L' instruction : 

File monFichier = new File ("truc.dat") ; 

cree un objet de type File, nomme monFichier, auquel est associe le nom truc.dat. 

On prendra garde a ne pas confondre un tel objet (cree en memoire) avec le fichier correspon- 
dant. Ainsi, la construction de l'objet monFichier ne cree aucun fichier. Si elle est necessaire, 
cette creation devra etre demandee explicitement par la suite. II pourra s'agir, par exemple, 
d'une ouverture en ecriture par un constructeur auquel on communiquera (on verra comment 
plus loin) l'objet monFichier au lieu de lui communiquer le nom true. data. Nous verrons ega- 
lement que la classe File dispose d'une methode de creation : 

boolean ok = monFichier . createNewFile ( ) ; // ok = true si la creation a eu lieu 
// la creation n' a lieu que si le fichier n' existe pas deja 

Malgre leur nom, les objets de type File peuvent etre associes, non seulement a un nom de 
fichier, mais aussi a un nom de repertoire. 
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Le nom d'un objet de type File (fichier ou repertoire) peut etre forme d'un simple nom avec 
une eventuelle extension, comme dans notre precedent exemple. II peut egalement comporter 
un chemin, lequel peut etre indifferemment : 

• absolu, c'est-a-dire specifie integralement depuis la racine du systeme de fichiers ; 

• relatif, c'est-a-dire se referer au repertoire courant. 

Si vos programmes ne sont destines qu'a un seul environnement, vous pouvez utiliser les 
conventions en vigueur dans cet environnement, par exemple : 

• les noms absolus sous Windows commencent par X: (X etant un nom d' unite) ou par V 
(dans ce cas, ils se referent a l'unite courante) ; sous Unix ou Linux, ils commencent par / ; 

• sous Windows, on utilise le caractere \ comme separateur de noms de repertoires ; sous Unix 
ou Linux, on utilise /. 

En revanche, si vous visez la portability, il est preferable de s'appuyer sur la constante 
File. separator de la classe File, qui fournit le separateur en vigueur dans 1' environnement 
concerne 2 . 

Voici quelques exemples : 

File monRepertl = new File ("c:\\ javaWexemplesWcours") ; 

// nom de repertoire absolu sous Windows 
File monRepert2 = new File ("/nome/delannoy/java/essais") 

// nom de repertoire absolu sous Unix 
File monRepert3 = new File ("java/essais") ; 

// nom de repertoire relatif sous Unix 

File monFichierl = new File ("c :\\ javaW exemple s\\ coursWentiers .bin") ; 

// nom de fichier absolu sous Windows 
File monFichier2 = new File ("entiers.bin") ; 

// nom de fichier relatif dans n' importe quel environnement 

String s = File . separator ; 

File monRepert3 = new File (s+"java") ; 

// nom de repertoire universel 3 
File monFichier3 = new File (s+"java"+s+"exemples"+s+"cours") ; 

// nom de fichier absolu universel 

File monRepert4 = new File ("java"+s+"essais") ; 

// nom de repertoire relatif universel 
File monFichier4 = new File ("java"+s+"essais"+"entiers.bin") ; 

// nom de fichier relatif universel 



1. N'oubliez pas que, pour introduire ce caractere dans une chaine, il faudra ecrire \\. 

2. Toutefois, cela ne regie pas le probleme du nom d'unite sous Windows ! 

3. Mais relatif a l'unite courante, sous Windows. 
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Dans le cas d'un fichier, on peut egalement construire l'objet File correspondant a partir de 
deux informations : le nom de repertoire d'une part (toujours absolu ou relatif), le nom de 
fichier d' autre part. En voici un exemple : 

File monFichier5 = new File ("java"+s+"essais", "entiers.bin") ; 

ou, ce qui revient au meme : 

String rep = " java"+s+"essais" ; 

File monFichier = new File (rep, "entiers.bin") ; 

Le nom de repertoire (mais pas le nom de fichier) peut etre fourni par un objet de type File, 
comme dans : 

String rep = " java"+s+"essais" ; 
File repert = new File (rep) ; 

File monFichier = new File (repert, "entiers.bin") ; 



5.2 Utilisation d'objets de type File 

5.2.1 Dans les constructeurs de flux 

On peut utiliser un objet de type File en lieu et place des noms de fichiers dans les construc- 
teurs de bon nombre de classes flux. Par exemple, au lieu de : 

DataOutputStream sortie = new DataOutputStream 

( new FileOutputStream ("entiers.dat)) ; 

vous pourriez utiliser : 

File objFich = new File ("entiers.dat") ; 
DataOutputStream sortie = new DataOutputStream 

( new FileOutputStream (objFich)) ; 

Bien entendu, cette demarche aura surtout un interet si Ton cherche a exploiter les autres 
fonctionnalites de la classe File, dont les principales sont exposees ci-dessous. 



5.2.2 Creation et suppression 

Si Ton dispose d'un objet de type File associe a un fichier ou a un repertoire, on peut creer ou 
supprimer le fichier ou le repertoire correspondant a l'aide des methodes suivantes : 

boolean createNewFile () 

Cree un nouveau fichier qui doit ne pas exister ; renvoie true si la creation s'est 
deroulee convenablement. 

boolean delete () 

Essaie de supprimer le fichier ; renvoie true si la suppression a eu lieu. Si le fi- 
chier n'existe pas, renvoie false. 
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boolean mkdir () 

Cree un repertoire ayant le nom correspondant ; renvoie true si la creation s'est 
deroulee correctement. Seul le dernier niveau de repertoire peut etre cree avec 
cette methode. 

boolean mkdirs () 

Fonctionne de facon semblable a mkdir, mais en acceptant de creer d'eventuels 
niveaux intermediaires de repertoires. 

5.2.3 Test d'existence 

boolean exists () 

Fournit true si le fichier correspondant existe. 
boolean isFile () 

Fournit true si l'objet correspond a un nom de fichier (independamment de 
l'existence de ce fichier). 

boolean isDirectory () 

Fournit true si l'objet correspond a un nom de repertoire (independamment de 
l'existence de ce repertoire). 

5.2.4 Informations 

long length () 

Fournit la longueur du fichier, en octets (0 s'il n' existe pas ou s'il est vide). 
String getName () 

Fournit une chaine contenant le nom correspondant (sans nom de chemin). 
boolean isHidden () 

Fournit true si l'objet correspond a un fichier cache, 
boolean canRead () 

Fournit true si l'objet correspond a un fichier autorise en lecture, 
boolean canWrite () 

Fournit true si l'objet correspond a un fichier autorise en ecriture. 
boolean canExecute () 

Fournit true si l'objet correspond a un fichier programme executable, 
boolean setFteadOnly () 

Marque l'objet comme etant en lecture seule. 
boolean setFteadable (boolean lisible [, boolean propri taireSeul]) // Depuis Java 6 

Positionne l'indicateur d'autorisation de lecture du fichier a la valeur indiquee 

(lisible), soit pour tous les utilisateurs, soit pour le proprietaire seul (si proprie- 

taire est fourni et qu'il vaut vrai). 
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boolean setWriteble (boolean ecriture [, boolean propri taireSeul]) // Java 6 

Positionne l'indicateur d'autorisation d' ecriture du fichier a la valeur indiquee 
(ecriture), soit pour tous les utilisateurs, soit pour le proprietaire seul (si pro- 
prietaire est fourni et qu'il vaut vrai). 

boolean setExecutable (boolean ex cutable [, boolean propri taireSeul]) // Java 6 

Positionne l'indicateur d'autorisation d'execution du fichier a la valeur indi- 
quee (executable), soit pour tous les utilisateurs, soit pour le proprietaire seul (si 
proprietaire est fourni et qu'il vaut vrai). 

5.2.5 Acces aux membres d'un repertoire 

II est possible de connaitre la liste de tous les membres (repertoires et fichiers) d'un repe- 
rtoire donne. Pour cela, vous disposez de deux methodes : 

String [] list () 

Fournit un tableau de chaines correspondant. 

FileQ listFiles () 

Fournit les memes informations que la methode precedente, mais sous la forme 
plus pratique d'un tableau d'objets de type File. 

Voici, par exemple, comment obtenir la liste de tous les sous-repertoires et fichiers apparte- 
nant a un repertoire dont on fournit le nom dans la variable nomRepert : 

String nomRepert = " " ; // nom de repertoire 

File repert = new File (nomRepert) ; 
Stringf] liste = repe.listO ; 
for (int i=0 ; Kliste. length ; i++) 
System. out. println (liste! i] ) ; 

Voici comment obtenir le meme resultat avec listFiles. II est alors facile d'exploiter tous les 
objets File ainsi crees, par exemple pour obtenir des informations sur les fichiers (en 
employant les methodes isFile et length) : 

String nomRepert = " " ; // nom de repertoire 

File repert = new File (nomRepert) ; 
File! ] liste = repe. listFiles () ; 
for (int i=0 ; Kliste. length ; i++) 

System. out. println (liste! i] .getNameO) ; 

5.2.6 Informations concernant les partitions 

Depuis Java 6, on dispose des trois methodes suivantes : 
long getTotalSpace () // Depuis Java 6 

Fournit la taille de la partition (en octets), 
long getFreeSpace () // Depuis Java 6 

Fournit la taille disponible sur cette partition (en octets), 
long getUsableSpace () // Depuis Java 6 

Fournit la taille disponible a la machine virtuelle sur cette partition (en octets). 
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6 Les flux en general 

Au fil des precedents paragraphes, nous vous avons presente les principales fonctionnalites 
des classes flux utilisees dans les situations les plus courantes que constituent les operations 
sur les fichiers. Mais, comme nous F avons signale, la notion de flux est plus generale que 
celle de fichier, puisqu'elle designe simplement un "canal" qui peut etre connecte a differen- 
tes sources ou a differentes cibles : fichier, peripherique de communication, mais aussi 
emplacement memoire ou site distant. 

Apres quelques indications generales, nous vous proposons ici la description des classes flux 
les plus usuelles. Vous y trouverez a la fois un recapitulatif des en-tetes et du role des metho- 
des deja presentees, ainsi que quelques methodes dont le role va de soi. 

6.1 Generalit.es 

Les differentes classes de flux peuvent se repartir en 5 families, chacune issue d'une classe de 
base abstraite : 

• OutputStream : flux binaires de sortie ; 

• InputStream : flux binaires d' entree ; 

• RandomAccessFile : fichiers a acces direct ; 

• Writer : flux texte de sortie ; 

• Reader : flux texte d'entree. 

Hormis la classe RandomAccessFile, reservee a des fichiers, les 4 autres classes de base 
n'imposent pas un flux de nature precise. Mais, dans chacune de ces 4 families, on trouvera 
des classes specialisees pour des flux associes a un fichier ou a un emplacement memoire. En 
revanche, rien de comparable n'existe pour un flux associe a un site distant. En fait, cette 
association s'obtiendra en creant un objet de type URL 1 et en lui appliquant la methode 
openStream qui fournit un objet de type inputStream. 

Par ailleurs, il existe des classes particulieres (dites souvent "filtres") qui se construisent sur 
un objet flux existant auquel elles ajoutent de nouvelles fonctionnalites. C'est ainsi que la 
classe DataOutputStream permet de completer un objet de type OutputStream (done aussi un 
objet de type FileOutputStream) en le dotant des possibilites d'ecriture de valeurs d'un type 
primitif. II en va de meme pour BufferedOutputStream. Ces filtres peuvent eventuellement se 
composer comme dans : 

DataOutputStream sortie = new DataOutputStream 

( new BufferedOutputStream 

( new FileOutputStream ("true"))) ; 



1. Uniform Ressource Locator : notation universelle d'une adresse Internet. 
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Notez que certains de ces filtres sont derives d'une classe dont le nom evoque effectivement 
un filtre {FilterOutputStream et FilterlnputStream). Mais il existe d'autres classes qui peu- 
vent aussi (eventuellement) etre utilisees comme un filtre, par exemple BufferedWriter. D'une 
maniere generale, pour voir comment composer ainsi plusieurs classes, et done en utiliser 
certaines comme filtres, ce n'est pas tant leur diagramme d' heritage qui compte que les argu- 
ments de leurs constructeurs. 



6.2 Les flux binaires de sortie 



Les classes les plus usuelles sont organisees suivant la hierarchie suivante : 



OutputStream 

FileOutputStream 
FilterOutputStream 
DataOutputStream 
BufferedOutputStream 
B yte Array Output S tre am 



// base 

//fichiers binaires de sortie 
// base des filtres de flux binaires de sortie 
//filtre permettant la lecture des types primitifs 
//filtre permettant I' utilisation d'un tampon 
//simulation de la sortie d'unfichier binaire 
// dans un tableau d' octets 



OutputStream 



Classe abstraite, base des classes relatives a des flux binaires de sortie, dotee de 
fonctionnalites rudimentaires (ecriture d'octets ou de tableaux d'octets). 



void 
void 
void 
void 



write (int n) 
write (byte[] b) 
closeQ 
flushQ 



// ecrit I'octet de poids faible de n 
// ecrit le tableau d'octets b 
// ferme le flux 
// vide le tampon, s'il existe 

FileOutputStream 

Flux binaire de sortie, associe a un fichier. Cette classe est dotee des memes 
fonctionnalites rudimentaires que OutputStream. 

FileOutputStream (String nomFichier) 

FileOutputStream (String nomFichier, boolean ext) //si ext == true, 

// ouverture en extension (append) 

FileOutputStream (File objFichier) 
FilterOutputStream 

Filtres de flux binaires de sortie, e'est-a-dire de classes qui ajoutent des fonc- 
tionnalites supplementaires a un flux binaire de sortie. 
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DataOutputStream 

Permet de doter un flux binaire de sortie de possibilites d'ecriture des differents 
types primitifs. 

DataOutputStream (OutputStream fluxSortie) 

void writeTttt (Tttt valeur) // ecrit une information d'un type primitif Tttt 
// Tttt = Boolean, Byte, Char, Short, Int, Long, Float, Double 

void writeChars (String chame) //ecrit les caracteres de la chained 

void writeUTF (String chame) //ecrit les caracteres de la chaine en format UTF 2 

BufferedOutputStream 

Permet de doter un flux binaire de sortie d'un tampon. 

BufferedOutputStream (OutputStream fluxSortie) 
BufferedOutputStream (OutputStream fluxSortie, int tailleTampon) 
void flush() // vide le tampon 

ByteArrayOutputStream 

Flux binaires de sortie, associes a un emplacement en memoire dont la taille 
sera etendue au fur et a mesure des besoins. 

ByteArrayOutputStream () 
ByteArrayOutputStream (int taillelnitiale) 
int size() // fournit le nombre de caracteres presents dans le tampon 

6.3 Les flux binaires d'entree 

Les principales classes sont organisees suivant la hierarchie suivante : 

InputS tream //base 

FilelnputStream // fichiers binaires d'entree 

FilterlnputStream // base desfiltres de flux binaires d'entree 

DatalnputStream //filtre permettant Vecriture des types primitifs 

BufferedlnputStream //filtre permettant V utilisation d'un tampon 

By teArray InputS tream //simulation de la lecture d'unfichier binaire 

// a partir d'un tableau d'octets 



1. Le nombre de caracteres ecrits depend done du contenu de la chaine, ce qui fait que cette methode est peu 
utilisee (il n'existe d'ailleurs pas de methode symetrique readChars). 

2. Le format UTF ( Unicode Text Format) permet de coder une chaine sous forme d'une suite d'octets en nombre 
variable, chaque caractere etant code sur un a trois octets, les plus courants l'etant sur un octet (alors qu'en for- 
mat Unicode usuel, chaque caractere se trouve code systematiquement sur 2 octets). La methode writeUTF pre- 
sente l'avantage sur writeChars de disposer d'une methode symetrique readUTF. 
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InputStream 



int 
int 

void 
void 



Classe abstraite, base de toutes les classes correspondant a des flux binaires 
d' entree, et dotee de fonctionnalites rudimentaires (lecture d' octets ou de ta- 
bleaux d'octets). 

read () // lit un octet (- 1 si fin du flux atteinte) 

read (byte[] b // lit une suite d'octets (au plus b.length)dans b 

// fournit le nombre d'octets lus (- 1 si fin de flux) 

closeQ // ferme le flux 

skip (long n) //saute n octets dans le flux ; fournit le nombre 

// d'octets effectivement sautes 



FilelnputStream 

Flux binaire d' entree, associe a un fichier. Cette classe est dotee des memes 
fonctionnalites rudimentaires que InputStream. 

FilelnputStream (String nomFichier) 
FilelnputStream (File objFichier) 

FilterlnputStream 

Filtres de flux binaires d'entree, c'est-a-dire de classes qui ajoutent des fonc- 
tionnalites supplementaires a un flux binaire d'entree. 

DatalnputStream 

Permet de doter un flux binaire d'entree de possibilites de lecture des differents 
types primitifs. 

DatalnputStream (InputStream fluxEntree) 

Tttt readTttt () // lit une information d'un type primitif Tttt 

// Tttt = Boolean, Byte, Char, Short, Int, Long, Float, Double 

String readUTF() //lit une chafne de caractere supposee codee en format UTP 
BufferedlnputStream 

Permet de doter un flux binaire d'entree d'un tampon. 

BufferedlnputStream (InputStream fluxEntree) 
BufferedlnputStream (InputStream fluxEntree, int tailleTampon) 

ByteArraylnputStream 

Flux binaire d'entree, associe a un emplacement en memoire. 
ByteArraylnputStream (byte[] t) 



1. Voir note 2, page precedence. 
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6.4 Les fichiers a acces direct 

Random AccessFile 

RandomAccessFile (File ObjetFichier, String modeOuverture) 

// mode = "r" ou "rw" 

RandomAccessFile (String nomFichier, String modeOuverture) 

void writeTttt (Tttt valeur) // ecrit une information d'un type primitif Tttt 
// Tttt = Boolean, Byte, Char, Short, Int, Long, Float, Double 

Tttt readttt () // lit une information d'un type primitil 'Tttt 

void seek (long position) 

long length () 

long getFilePointer () 



6.5 Les flux texte de sortie 



Les principales classes sont organisees suivant la hierarchie suivante 



Writer 

Outputs treamWriter 
Filewriter 
PrintWriter 
BufferedWriter 
Char Array Writer 



// base 

// flux texte de sortie 
//fichiers texte de sortie 

//flux texte de sortie avec formatage des types primitifs 
// filtre pour ajouter un tampon a unflux texte 
//flux texte de sortie en memoire 



Writer 



Classe de base de toutes les classes relatives a des flux texte de sortie, dotee de 
fonctionnalites rudimentaires (ecriture d'un caractere ou d'un tableau de carac- 
teres). 

// ecrit le caractere n 
// ecrit le tableau de carateres tabCar 
// ferme le flux 
// vide le tampon s'il existe 



void write (int n) 

void write (char[] tabCar) 

void close () 

void flush 0 



OutputStreamWriter 

Flux texte de sortie. Cette classe est dotee des memes fonctionnalites que Wri- 
ter. 

OutputStreamWriter (OutputStream fluxSortie) 
FileWriter 

Flux texte de sortie, associes a un fichier. 

FileWriter (File ObjetFichier) 
FileWriter (String nomFichier) 

FileWriter (String nomFichier, boolean ext) //si ext == true, ouverture 

// en extension (append) 



Les flux et les fichiers 

Chapitre 20 



PrintWriter 

Flux texte de sortie, dotes de possibilites de formatage avec print et println. 

PrintWriter (OutputStream fluxSortie) 

PrintWriter (Writer fluxTexteSortie) 

PrintWriter (OutputStream fluxSortie, boolean vidageAuto) 

//si vidageAuto = true, le tampon est vide a chaque appel de println 

PrintWriter (Writer fluxTexteSortie, boolean vidageAuto) 

//si vidageAuto = true, le tampon est vide a chaque appel de println 

void print (Tttt valeur) 

// Tttt = boolean, byte, char, short, int, long, float, double, 
// char[], String ou Object 

void println (Tttt valeur) 

// Tttt = boolean, byte, char, short, int, long, float, double, 
// char[], String ou Object 



BufferedWriter 

Permet de doter un flux texte d'un tampon. 

BufferedWriter (Writer fluxTexteSortie) 
BufferedWriter (Writer fluxTexteSortie, int tailleTampon) 



CharArrayWriter 

Flux texte de sortie associes a un emplacement memoire (dont la taille sera eten- 
due au fur et a mesure des besoins). 

CharArrayWriter () 
CharArrayWriter (int taillelnitiale) 

6.6 Les flux texte d'entree 

Les principales classes sont organisees suivant la hierarchie suivante : 

Reader // base 

InputStreamReader //flux texte d'entree 

FileReader //fichiers texte d'entree 

BufferedReader // filtre pour ajouter un tampon a unflux texte d'entree 

CharArray Reader //flux texte d'entree en memoire 
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Reader 

Classe abstraite, base de toutes les classes relatives a des flux texte d'entree, do- 
tee de fonctionnalites rudimentaires (ecriture de caracteres et de tableaux de ca- 
racteres). 

int read () //lit un caractere (fournit -1 si fin de flux) 

int read (char[] tabCar) //lit une suite de caracteres (au plus b.length) 

// dans b ; fournit le nombre d'octets lus (- 1 si fin de flux) 

void close () // ferme le flux 

long skip (long n) //saute n caracteres dans le flux ; fournit le nombre 

//de caracteres effectivement sautes 

InputStreamReader 

Flux texte d'entree. Cette classe est dotee des memes fonctionnalites que 
Reader. 

InputStreamReader (InputStream fluxEntree) 
FileReader 

Fichiers texte d'entree. Cette classe est dotee des memes fonctionnalites que 
Reader. 

FileReader (File objetFichier) 
FileRreader(String nomFichier) 

Buffered Reader 

Permet de doter un flux texte d'entree d'un tampon et de fonctionnalites de lec- 
ture globale d'une ligne. 

Buffered Reader (Reader fluxTexteEntree) 
BufferedWriter (Reader fluxTexteEntree int tailleTampon) 
String readLine () // Lit une ligne de texte 

CharArrayReader 

Flux texte d'entree associes a un emplacement memoire existant. 
CharArrayReader (charQ tabCar) 



7 Les sockets 

Comme nous l'avons dit en introduction, la notion de flux est tres generale puisqu'elle desi- 
gne n'importe quel "canal" suceptible de transmettre de l'information sous forme d'une suite 
d'octets. Notamment, cette notion s'applique aux connexions TCP/IP entre ordinateurs utili- 
sant le protocole telnet. Dans ce cas, un des ordinateurs est considere comme serveur et le 
service offert est caracterise par : 

• l'adresse IP de l'ordinateur, par exemple : 127 . 0 . 0 . 1 ; 
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• le numero de port sur lequel on a choisi d'ouvrir le service ; notez bien que ce numero n'a 
rien a voir avec les "ports physiques" de Fordinateur. II sert simplement a "identifier" un 
service donne. 

Voyons comment proceder, en distinguant le code utilise par le serveur de celui utilise par les 
"clients". 

7.1 Cote serveur 

Pour que le serveur soit pret a recevoir des informations, on devra creer un objet de type Ser- 
verSocket, associe au numero de port choisi (ici, port) : 

ServerSocket sersoc = new ServerSocket (port) ; 

On obtiendra ensuite une "socket" associee a cet objet, en utilisant la methode accept : 

Socket soc = sersoc. accept () ; 

Puis la methode getlnputStream de la classe Socket permettra d'obtenir un flux de type 
InputStream associe a cette socket : 

InputStream flux = soc. getlnputStream () ; 

On pourra ensuite lire classiquement des informations sur ce flux, comme nous avons appris 
a le faire precedemment. Par exemple, on pourra lire de simples lignes de texte, en creant un 
objet de type BufferedReader : 

Buf feredReader lecteur = new BufferedReader (new InputStreamReader (flux) ) ; 

Chaque ligne sera lue par une instruction de la forme (message etant de type String) : 

message = lecteur . readLine ( ) ; 
A titre indicatif, voici un programme tres simple realisant ces operations : 

import j ava . io . * ; 
import java.net.* ; 

public class Serveur 

{ public static void main (String args[ ] ) throws IOException 
{ int port = 1000 ; 

ServerSocket sersoc = new ServerSocket (port) ; 

System. out .println ("serveur active sur port " + port) ; 

while (true) 

{ Socket soc = sersoc. accept () ; 

InputStream flux = soc. getlnputStream (); 

BufferedReader entree = new BufferedReader (new InputStreamReader (flux) ) ; 
String message = entree . readLine ( ) ; 

System. out. println ("message recu sur le serveur = " + message) ; 

} 

} 

} 



Lecture de "lignes de texte " par un serveur sur le port 1000 
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7.2 Cote client 

Pour pouvoir communiquer avec le serveur, le client creera un objet de type Socket, associe a 
la fois a l'adresse IP du serveur (hote) et au numero de port du service (port) : 

Socket soc = new Socket (hote, port) ; 

Pour "emettre" sur cette socket, on lui associera un flux de type OutputStream par: 

OutputStream flux = soc . getOutputStream ( ) ; 

Comme ici nous avons prevu que le serveur "lise" des lignes de texte, nous construirons sur 
cette socket un objet de type OutputStreamWriter : 

OutputStreamWriter sortie = new OutputStreamWriter (flux) ; 

sur lequel il nous suffira d"'ecrire" les lignes voulues par des instructions telles que : 

sortie . write ( ) ; 

Voici un programme tres simple se contentant d'envoyer une ligne de texte au serveur 
precedent : 

import java.net.* ; 
import java.io.* ; 
public class Client 

{ public static void main (String args[ ] ) throws IOException 
{ String hote = "127.0.0.1" ; 
int port = 1000 ; 

Socket soc = new Socket (hote, port) ; 
OutputStream flux = soc . getOutputStream ( ) ; 
OutputStreamWriter sortie = new OutputStreamWriter (flux) ; 
sortie. write ("message envoye au serveur \n") ; 
sortie . flush () ; // pour forcer 1' envoi de la ligne 

} 

) 



Envoi d'une ligne de texte au serveur 

Ici, le serveur affichera : 

serveur active sur port 1000 

message recu sur le serveur = message envoye au serveur 
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La programmation generique 



On parle generalement de programmation generique lorsqu'un langage permet d'ecrire un 
code source unique utilisable avec des objets ou des variables de types quelconques. On peut 
prendre l'exemple d'une methode de tri applicable a des objets de type quelconque ou encore 
celui d'une classe permettant de manipuler des ensembles d' objets de type quelconque. 
Cependant, le terme "generique" reste imprecis puisqu'il peut recouvrir deux aspects 
differents : 

• soit le type en question est effectivement quelconque au sens ou au sein d'une me me instan- 
ce de classe ou au sein d'un meme appel de methode, on peut manipuler des objets de dif- 
ferents types ; avec nos exemples precedents, un meme tri pourrait alors concerner des 
objets de type Point, Double, String... ou un meme ensemble comporterait des elements de 
type Point, Double, String... 

• soit le type en question, non precise lors de l'ecriture de la classe ou de la methode, se trouve 
fixe de facon unique au moment de l'instanciation de la classe ou de F appel de la methode ; 
avec nos exemples precedents, une meme methode de tri pourrait etre appelee sur des objets 
de type Point, puis une autre fois sur des objets de type Double... De meme, on pourrait ins- 
tancier un ensemble de Point, puis un ensemble de Double... 

La premiere possibility est offerte depuis la premiere version de Java, par le biais de 
1' heritage (n'oubliez pas que toute classe derive au moins de la classe Object). La seconde 
possibility a ete introduite par le JDK 5.0, sous forme de "parametres de types" utilisables 
aussi bien dans des classes que dans des methodes. On parle alors de classes generiques ou de 
methodes generiques. 
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A priori, ces classes et methodes generiques ont surtout ete introduites pour "securiser" l'uti- 
lisation des Collections (listes, ensembles...) qui seront etudiees plus loin : en parametrant le 
type des objets qu'elles renferment, on assurera son unicite au sein de la collection. 
Neanmoins, il est bon d'etudier ce mecanisme de programmation generique afin, par la suite, 
de mieux utiliser les collections generiques, voire de melanger des codes utilisant les ancien- 
nes et les nouvelles collections. Cela permettra egalement de comprendre les compromis faits 
par les concepteurs dans la mise en ceuvre de cette genericite, notamment pour assurer la 
compatibilite avec les versions precedentes de Java (le JDK 5.0 apparait 10 ans apres la pre- 
miere version de Java !). 

Nous commencerons par vous presenter la notion de parametre de type, au sein d'une classe 
ou d'une methode. Nous vous montrerons ensuite comment ce parametre est "traite" par le 
compilateur, ce qui nous amenera a presenter la notion d'effacement ; nous verrons que celle- 
ci correspond a un choix technologique des concepteurs de Java et qu'elle se repercute de 
facon importante sur les restrictions qui pesent sur la programmation generique. 

Nous traiterons ensuite des methodes generiques. Puis nous verrons comment il est possible 
d'imposer des limitations aux parametres de type lors de la conception des classes ou des 
methodes generiques. Nous examinerons ensuite comment la programmation generique 
influe sur la notion d' heritage ; nous verrons notamment qu'une relation d' heritage entre 
deux classes ne se retrouve pas entre classes generiques construites sur ces deux classes, ce 
qui peut s'averer contraignant dans certains cas. Nous apprendrons alors comment pallier 
cette contrainte grace a la notion de joker. 

1 Notion de classe generique 

1 .1 Exemple de classe generique a un seul parametre de type 

Voyons comment Java permet de mettre en ceuvre une classe generique. Nous commencerons 
par un exemple dans lequel n'intervient qu'un seul parametre de type, a savoir une classe per- 
mettant de manipuler des "couples" d'objets, c'est-a-dire la reunion de deux objets d'un 
meme type. Par souci de simplicite, notre classe ne disposera que des methodes suivantes (en 
pratique, on trouverait au moins la methode getSecond) : 

• un constructeur, recevant les valeurs des deux elements du couple, 

• une methode nommee affiche, affichant les valeurs des deux elements du couple, 

• une methode nommee getPremier, fournissant la valeur du premier element du couple. 

1.1.1 Definition de la classe 

La definition de notre classe generique pourrait se presenter ainsi : 

class Couple<T> 

{ private T x, y ; // les deux elements du couple 

public Couple (T premier, T second) 
{ x = premier ; y = second ; 
} 
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public void affiche () // x et y convertis automatiquement par toString 

{ System. out. println ("premiere valeur : " + x + " - deuxieme valeur : " + y) ; 

} 

T getPremier () 
{ return x ; 
} 

} 

On note la presence d'un "parametre de type" nomme ici T, dans : 

class Couple<T> 

II sert a preciser que, dans la definition de classe qui suit, T represente un type quelconque. 
Ce parametre Tpeut alors etre utilise la oil un type precis peut l'etre normalement. Ici, on le 
rencontre : 

• dans les declarations des champs x et y, 

• dans Fen-tete du constructeur et de la methode getPremier. 



Remarques 

1 Le nom du parametre de type (ici, 7) peut theoriquement etre n'importe quel identifica- 
teur. Cependant, pour augmenter la lisibilite des codes, on recommande generalement 
d'employer une seule lettre majuscule. 

2 Notez bien que la methode affiche se contente d'afficher des chaines obtenues en appli- 
quant (implicitement) la methode toString aux deux objets x et y. 

1.1.2 Utilisation de la classe 

Lors de la declaration d'un objet de type Couple, on devra preciser le type effectif correspon- 
dant a T, de cette maniere : 

Couple <Integer> ci ; // ci est un Couple d objets de type Integer 
Couple <Point> cp ; // cp est un Couple d' objets de type Point 

La seule contrainte a respecter a ce niveau est que ce type doit obligatoirement etre une 
classe ; la declaration suivante serait rejetee : 



Lappel du constructeur devra egalement preciser le type voulu. Par exemple, si Ton dispose 
de deux objets oil et oil de type Integer, on creera le couple correspondant par : 

ci = new Couple<Integer> (oil, oi2) ; 

Lappel de la methode affiche se fera "classiquement" : 

ci. affiche () ; 

Ici, l'information de type n'est plus utile, puisqu'elle est "contenue" dans le type de ci. 

De meme, pour obtenir le premier element du couple ci, on utilisera : 

ci . get ( ) 

qui fournira un resultat de type Integer. 




Couple <int> c ; 



// erreur : int n' est pas une classe 
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Voici un exemple de programme complet reprenant toutes ces possibilites (on y fait appel aux 
possibilites d'emballage/deballage automatique, explicitees dans des commentaires) : 

public class CoupleH 

{ public static void main (String args[ ] ) 

{ Integer oil = 3 ; // equivalent a : Integer oil = new Integer (3) ; 
Integer oi2 = 5 ; // equivalent a : Integer oi2 = new Integer (5) ; 
Couple <Integer> ci = new Couple<Integer> (oil, oi2) ; 
ci.affiche () ; 

Couple <Double> cd = new Couple <Double> (2.0, 12.0) ; 

//on peut f ournir des arguments de type double qui seront 

/ / convertis automatiquement en Double 
cd.affiche () ; 

Double p = cd . getPremier () ; 

System. out .println ("premier element du couple cd = " + p ) ; 

} 

} 

class Couple<T> 

{ private T x, y ; // les deux elements du couple 

public Couple (T premier, T second) 
{ x = premier ; y = second ; 
} 

public T getPremier () 

{ return x ; } 

public void affiche () 

{ System. out .println ("premiere valeur : " + x + " - deuxieme valeur : " + y ) ; 
} 



premiere valeur : 3 - deuxieme valeur : 5 
premiere valeur : 2.0- deuxieme valeur : 12 . 0 
premier element du couple cd = 2.0 

Definition et utilisation d'une classe generique a un parametre de type 



TSf- En C++ 

C++ dispose egalement de possibilites de programmation generique ; on parle alors sou- 
vent de "patrons de classe" (en anglais templates). Si la syntaxe utilisee par C++ est voi- 
sine de celle de Java, nous verrons qu'elle cache en fait des fonctionnalites totalement 
differentes. 

1 .2 Exemple de classe generique a plusieurs parametres de type 

Notre exemple precedent ne comportait qu'un seul parametre de type. Bien entendu, une 
classe generique peut en comporter plusieurs. Voici un exemple qui generalise la classe Cou- 
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pie precedente au cas oil les deux elements du couple ne sont plus necessairement du meme 
type: 

public class CoupleM 

{ public static void main (String args[ ] ) 
{ Integer oil = 3 ; 
Double odl = 2.5 ; 

Couple <Integer, Double> chl = new Couple <Integer, Double> (oil, odl) ; 
chl . af f iche ( ) ; 

Integer oi2 = 4 ; 

Couple <Integer, Integer> ch2 = new Couple <Integer, Integer> (oil, oi2) ; 
ch2.affiche () ; 

Integer n = chl . getPremier ( ) ; 

System. out. println ("premier element du couple chl = " + n ) ; 

} 

} 

class Couple<T, U> 

{ private T x ; // le premier element du couple 

private U y ; // le second element du couple 
public Couple (T premier, U second) 
( x = premier ; y = second ; 
} 

public T getPremier () 

{ return x ; 

} 

public void affiche () 

{ System . out . println ("premiere valeur : " + x + " - deuxieme valeur : " + y) ; 
} 

} 

premiere valeur : 3 - deuxieme valeur : 2.5 
premiere valeur : 3 - deuxieme valeur : 4 
premier element du couple chl = 3 

Exemple de classe generique a plusieurs parametres de type 

2 Compilation du code generique 

2.1 Introduction 

Jusqu'ici, nous nous sommes contentes de dire qu'un symbole tel que T representait un para- 
metre de type, sans trop preciser l'usage qu'en faisait le compilateur. Or, dans le JDK 5.0, les 
concepteurs ont choisi un compromis dans la mise en ceuvre de la programmation generique, 
en cherchant : 
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• a realiser le maximum de diagnostics en compilation (il n'y a done pas necessairement ex- 
haustivite dans ce domaine), 

• a assurer la compatibilite avec les anciennes versions, en permettant notamment de meler 
code generique et code non generique (ce qui aura un grand interet au niveau des collec- 
tions). 

II en resulte que les regies de developpement de code generique sont assez complexes et sur- 
tout qu'elles comportent des limitations qui ne sont pas du tout inherentes au concept theori- 
que de genericite meme. Les choses deviennent toutefois plus comprehensibles (done 
probablement plus faciles a assimiler) si Ton connait le mecanisme dit d' effacement {erasure 
en anglais) qui est la cle de voute de ce compromis. C'est ce mecanisme 1 que nous vous pro- 
posons d' examiner maintenant. 

2.2 Compilation d'une classe generique 

Considerons notre classe Couple <T> introduite dans le paragraphe 1.1.1. Sa compilation 
conduit a creer les memes "byte codes" que si nous Favions definie ainsi (en supprimant la 
declaration de parametre de type <T> et en remplacant Tpar Object dans la suite) : 

class Couple 

{ private Object x, y ; 

public Couple (Object premier, Object second) 

{ x = premier ; y = second ; 

} 

public void affiche () 

{ System. out .println ("premiere valeur : " + x + " - deuxieme valeur : " + y) ; 
} 

Object getPremier () 

{ return x ; 

} 

} 

On dit que le type Couple<T> a ete remplace par un "type brut" (raw type en anglais), ici 
Couple. 

2.3 Compilation de I'utilisation d'une classe generique 

Dans I'utilisation de la classe generique Couple<T>, nous avions declare : 

Couple <Integer> ci ; 

Lorsque le compilateur rencontre un appel tel que : 

ci . getPremier ( ) 



1. II existe d'autres mecanismes d'implementation que nous n'evoquerons pas ici et qui ne figureront peut-etre 
pas dans les versions posterieures de Java. A titre anecdotique, on peut remarquer que, initialement, les codes 
generiques compiles avec le JDK 5.0 s'executaient convenablement sur des machines virtuelles anterieures 
alors qu'il n'en va plus de meme actuellement. 
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il le traduit en inserant une conversion du type Object dans le type Integer. En effet, a ce 
niveau : 

• le compilateur sait que, a cause de l'effacement, lors de l'execution, le resultat fourni par 
getPremier sera de type Object, 

• mais il connait quand meme le type de ci, grace a sa declaration. 

En definitive, tout se passera comme si vous aviez ecrit votre appel de cette facon : 

(Integer) ci . getPremier ( ) 

De la meme maniere, un appel tel que : 

Double d = ci . getPremier () ; 

sera bien rejete en compilation puisqu'il devrait etre traduit en : 

Double d = (Integer) ci . getPremier ( ) ; 

A ce niveau, done, l'incidence de l'effacement n'est guere perceptible pour le developpeur. 
Nous allons voir qu'il n'en va pas toujours ainsi. 

gjjf En C++ 

La gestion de la genericite en C++ est totalement differente puisqu'il y a creation d'un 
code source specifique pour chaque valeur de type ; cette creation n'est toutefois realisee 
que lorsque Ton a besoin d'instancier la classe correspondante (on parle parfois d'instan- 
ciation du code source de la classe dont on a besoin). Les classes generiques ne sont done 
pas totalement compilees en C++. Leur utilisation intensive peut entrainer une augmenta- 
tion du code source et des temps de compilation. En revanche, a l'execution, comme en 
Java, la notion de genericite a disparu. 

2.4 Limitations portant sur les classes generiques 

Le choix de l'effacement impose d'importantes contraintes aux classes generiques. Nous 
allons examiner ici les principales d'entre elles. 

2.4.1 On ne peut pas instancier un objet d'un type parametre 

Examinez cet exemple simple : 

class <T> Exple 

{ T x ; // reference a un objet de type T (OK) 
void f (...) 

{ x = new T(); / / interdit d' instancier un ob j et de type parametre T 

} 

} 

L appel new T() est rejete en compilation. En effet, au moment de l'execution, le type T aura 
disparu (il aura ete remplace par Object). La machine virtuelle n'a done plus aucun moyen de 
connaitre le type exact de l'objet a instancier. 



J La programmation generique 

Le meme probleme se posera pour des tableaux, et ce pour les memes raisons : 

class <T> Exple2 

{ T [ ] tab ; // reference a un tableau d' objets de type T (OK) 
void f (...) 

{ tab = new T [ 100] ; // interdit 

} 

) 

\^^~ Remarque 

Ne confondez pas cette situation d'instanciation d'un objet d'un type parametre au sein 
d'une classe generique, avec une instanciation d'un objet d'une classe generique, comme 
par exemple dans : 

new Couple <Double> (...) 

laquelle constitue le fondement de la programmation generique. En revanche, comme 
on va le voir ci-apres, 1' instanciation d'un tableau d'elements de type generique ne sera 
pas possible. 

2.4.2 On ne peut pas instancier de tableaux d'elements d'un type generique 

Toujours a cause du mecanisme d'effacement, il n'est pas possible d' instancier des tableaux 
d'un type generique. Par exemple, ayant defini notre type Couple<T> precedent, il n'est pas 
possible d'ecrire : 

Couple <Double> [ ] ted = new Couple <Double> [ 5] ; 
En effet, apres effacement, le type de ted est simplement Pair[]. 

II s'agit la d'une limitation tres severe (et assez inattendue). Rappelons toutefois que la pro- 
grammation generique a ete surtout introduite pour ameliorer l'utilisation des collections. 
D'ailleurs, le probleme evoque ici pour un tableau usuel disparaitra si Ton utilise a la place 
une collection telle que Array List. 

2.4.3 Seul le type brut est connu lors de I'execution 

Quand vous instanciez des objets tels que : 

Couple<String> cs = new Couple<String> ( ) ; 

Couple<Double> cd = new Couple<Double> ( ) ; 

Vous pensez peut-etre que cs et cd appartiennent a des classes differentes. Or, il n'en est rien, 
compte tenu de l'effacement. Apres compilation, pour la machine virtuelle, ces objets appa- 
raissent comme des instances du type brut Couple. 

Ainsi, les expressions suivantes seront vraies : 

cs instanceOf Couple // true 
cd instanceOf Couple // true 
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Informations complementaires 



Java dispose de fonctionnalites d'introspection (etudiees plus loin) qui permettent d'obtenir 
des informations sur une classe au moment de 1' execution. II est clair que ce mecanisme 
souffrira des lacunes evoquees ici et qu'il ne pourra fournir que le type brut d'une classe et 
en aucun cas, la valeur du parametre de type avec lequel elle a ete instanciee. 

2.4.4 Autres limitations 
Exceptions 

II n'est pas possible de creer une classe generique derivee de Throwable, done a fortiori de 
Exception ou de Error : 

class Exple <T> extends Exception // erreur de compilation 

{ 

} 

II n'est pas possible de lever une exception {throw) a Faide d'un objet d'une classe 
generique : 

throw (Couple <Integer>) // erreur de compilation 

De meme, on ne peut pas intercepter une exception en se basant sur un objet d'une classe 
generique : 

catch (Couple <Integer>) { } // erreur de compilation 

Champs statiques 

La encore, l'existence de Feffacement a des consequences importantes sur les champs stati- 
ques. 

• Si Ton definit un champ statique dans une classe generique, il sera unique pour toutes les 
instances de cette classe, quelle que soit la valeur du parametre de type. Par exemple, avec : 

class Couple <T> 

[ static int compte ; 

public Couple () { compte++ ; System. out. println ("compte = " + compte) ; } 

} 

on verra la valeur de compte s'accroitre a chaque instanciation d'un objet de type Couple, 
par exemle Couple<Point>, Couple<Double>... 

• Un champ statique ne peut pas etre d'un type parametre : 

class Couple <T> 

{ static T compte ; // erreur de compilation 

} 

£4}*" En C++ 

Compte tenu de la technique utilisee (creation a la demande du code source de chaque 
classe necessaire), C++ ne souffre d'aucune des limitations evoquees dans ce paragraphe. 
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3 Methodes generiques 

Nous venons de voir comment on pouvait introduire des parametres de type dans une classe. 
La meme demarche peut s'appliquer a une methode ; on parle alors tout naturellement de 
"methodes generiques". 

3.1 Exemple de methode generique a un seul argument 

Supposons que Ton souhaite disposer d'une methode statique permettant de tirer au hasard 
un element d'un tableau fourni en argument, de type quelconque. Elle pourrait se presenter 
ainsi : 

static <T> T hasard (T [ ] valeurs) 

{ // choisir au hasard une position i dans le tableau valeurs 
return valeurs[ i] ; 

} 

Voici comment nous pourrions utiliser notre methode hasard, ici sur un tableau d' elements 
de type Integer puis d' elements de type String : 

Integer! ] tabi = { 1,5, 8, 4, 9} ; 
Integer n = hasard (tabi) ; 

String[] tabs ={ "bonjour", "salut", "hello"} ; 
String s = hasard (tabs) ; 

La encore, la compilation de la methode generique conduit a l'effacement du type T, exac- 
teemnt comme si Ton avait defini hasard de cette facon : 

static Object hasard (Object [ ] valeurs) 
Les deux appels precedents sont traduits comme s'ils avaient ete ecrits : 

Integer n = (Integer) hasard (tabi) ; // insertion d' un cast par le compilateur 
String s = (String) hasard (tabs) ; // idem 

Ici, les effets de l'effacement ne sont pas tres apparents. Nous les verrons plus clairement un 
peu plus loin en considerant une methode a plusieurs arguments de meme type. 

Voici un exemple de programme complet (la methode Math.random tire au hasard une valeur 
de type double dans Fintervalle [0, 1[) : 

public class MethGenl 
{ static <T> T hasard (T [ ] valeurs) 
{ int n = valeurs . length ; 
if (n == 0) return null ; 
int i = (int) (n * Math . random ( ) ) ; 
return valeurs[ i] ; 

} 

public static void main (String args[ ] ) 
{ Integer[ ] tabi = { 1, 5, 8, 4, 9) ; 

System. out. println ("hasard sur tabi = " + hasard (tabi) ) ; 

String [] tabs = { "bonjour", "salut", "hello"} ; 

System. out. println ("hasard sur tabs = " + hasard (tabs) ) ; 

} 

} 



3 - Methodes generiques 



589 



hasard sur tabi = 9 
hasard sur tabs = hello 

Methode generique a un seul argument 

Remarques 

1 Ne confondez pas l'instanciation d'un tableau d'un type generique (dont on a vu qu'elle 
etait impossible) avec un tableau d'un type generique recu en argument, comme c'est le 
cas ici : le tableau correspondant existera bien au moment de l'appel et il aura ete instan- 
cie avec un type connu lors de la compilatione 

2 Ici, notre methode est statique. II est tout a fait possible de definir des methodes de 
classe qui soient generiques, mais cela est moins frequent ; en effet, pour que la 
methode soit generique (et pas seulement methode usuelle d'une classe generique), il 
faut que le parametre de type concerne ne fasse pas partie des eventuels parametres de 
type de la classe ; en voici deux cas d'ecole : 

class Explel <1> // classe generique a un parametre de type T 

{ public <U> void f (U u) // f recoit un argument de type U, alors qu' elle 

{ } // est deja methode d un objet (this) de type Explel<I> 

} 

class Exple2 // classe non generique 

{ public <U> void f (U u) // f recoit un argument de type U, ici elle est 
{ } // methode d un objet (this) de type Exple2 fixe 

} 

3.2 Exemple de methode generique a deux arguments 

Pour mieux mettre en evidence le mecanisme d'effacement, considerons une methode a deux 
arguments d'un meme type, a savoir une methode tirant au hasard un objet parmi deux objets 
de meme type Tfournis en arguments. Elle pourrait se presenter ainsi : 

public class MethGen2 
{ static <T> T hasard (T el, T e2) 
{ double x = Math . random ( ) ; 
if (x <0.5) return el ; 
else return e2 ; 

} 

Avec ces declarations : 

Integer nl = 2 ; // conversion automatique de int en Integer 
Integer n2 = 5 ; // idem 

Double xl = 2.5 ; // conversion automatique de double en Double 
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l'appel suivant est naturellement accepte : 

hasard (nl, n2) ; // deux arguments du meme type int 

Mais, celui-ci Test egalement : 

hasard (nl, xl) ; // accepte bien que les arguments soient de types differents 

alors que les deux arguments sont des types differents et qu'aucun des deux types n'est com- 
patible avec 1' autre. 

En fait, il ne faut pas perdre de vue que, compte tenu de l'effacement, la methode hasard est 
compilee comme si on Favait ecrite ainsi : 

static Object hasard (Object el, Object e2) 
{ double x = Math . random ( ) ; 
if (x <0.5) return el ; 
else return e2 ; 

} 

Si Ton souhaite davantage de verifications a la compilation, il est possible d'imposer le type 
voulu pour Tlors de l'appel de la methode, en utilisant une syntaxe de la forme suivante : 

nomClasse<type>.nomMethode 

Le nom nomClasse est celui de la classe dans laquelle est definie la methode (il y en a tou- 
jours une ; eventuellement il peut s'agir d'une unique classe principale...). Par exemple, si 
notre methode hasard est definie dans une classe nommee MethGenl : 

MethGen2.<Double> hasard (nl, xl) ; 

forcera le compilateur a verifier que les arguments (nl et xl) sont bien d'un type compatible 
avec Double 1 . Ici, on obtiendra bien une erreur de compilation. En revanche, cet appel sera 
accepte : 

MethGen2 .<Number> hasard (nl, xl) ; 

puisque les deux arguments sont d'un type compatible avec Number. 
Voici un petit programme complet recapitulant ces differents points : 

public class MethGen2 
{ static <T> T hasard (T el, T e2) 
{ double x = Math . random ( ) ; 
if (x <0.5) return el ; 
else return e2 ; 

} 

public static void main (String args[ ] ) 
{ Integer nl = 2 ; 

Integer n2 = 5 ; 

int n = hasard (nl, n2) ; 

System. out. println ("hasard (nl, n2) = " + n) ; 

Double xl = 2.5 ; 

Number v = hasard (nl, xl) ; 

System. out. println ("hasard (nl, xl) = " + v ) ; 



1. Notez qu'il n'existe aucun type compatible avec le type Double, en dehors de Double lui-meme. 
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Number w = MethGen2 .<Number> hasard (nl, xl) ; 
System. out. println ("hasard (nl, xl) = " + v ) ; 

// Number z = MethGen2 .<Double>hasard (nl, xl) ; // rejete en compilation 

} 

} 

hasard (nl, n2) =2 
hasard ' nl, xl) =2.5 
hasard ' nl, xl) =2 

Mise en evidence de Veffacement" sur une methode generique a deux arguments 

4 Limitations des parametres de type 

4.1 Exemple avec une classe generique 

Lorsque vous definissez une classe generique comme nous avons appris a le faire jusqu'ici, 
elle peut etre instanciee pour n'importe quelle "valeur" des parametres de type, du moment 
qu'il sagit bien de types classes. 

II est cependant possible, au moment de la definition de la classe, d'imposer certaines con- 
traintes. Plus precisement, on pourra imposer a la classe correspondant a un parametre de 
type d'etre derivee d'une classe donnee ou d'implementer une ou plusieurs interfaces. Par 
exemple, en definissant ainsi la classe Couple presentee au paragraphe 1.1 : 

class Couple <T extends Number> { // definition precedente inchangee } 

on imposera au type designe par T de deriver de la classe Number (ce qui est le cas des types 
enveloppes numeriques comme Integer, Float, Double...). 

Dans ces conditions, lors de la compilation de la classe, le mecanisme d'effacement de la 
classe Couple conduira a remplacer le type T, non plus par Object, mais par Number. Tout se 
passera comme si nous avions defini notre nouvelle classe Couple de la maniere suivante : 

class Couple 

{ private Number x, y ; 

public Couple (Number premier, Number second) { ) 

public void affiche () ) { ) 

Number getPremier () { return x ; ) 

} 

Ainsi, la declaration suivante sera rejetee par le compilateur : 

class Couple <Point> cp ; // erreur de compilation : Point ne derive pas de Number 

tandis que celle-ci sera acceptee : 

class Couple <Double> cd ; // OK 
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Par ailleurs, une expression telle que : 

cd . getPremier ( ) 

sera traduite comme si Ton avait ecrit : 

(Number) cd . getPremier ( ) 

4.2 Exemple avec une methode generique 

La meme demarche s' applique a une methode generique. Par exemple, nous pourrions definir 
ainsi la methode hasard presentee au paragraphe 3.1 : 

static <T extends Number> T hasard (T [ ] valeurs) 
{ / / definition precedente inchangee } 

La compilation de cette methode conduira a Feffacement du type T, exactement comme si on 
1' avait definie de cette fa9on : 

static Number hasard (Number [ ] valeurs) { } 

Un appel tel que : 

Double d ; 

d = hasard ( ) ; 

sera traduit comme si Ton avait ecrit : 

d = (Number) hasard ( ) ; 

4.3 Regies generales 

D'une maniere generale, dans une defintion de classe generique ou de methode generique, on 
peut imposer a une classe correspondant a un parametre de type, non seulement de deriver 
d'une classe donnee, mais aussi d' implementer une interface, comme dans : 

class Couple <T extends Comparable> // T doit implementer 1' interface Comparable 
{ } 

On notera que Java utilise le meme mot-cle extends, que Ton ait affaire a une derivation de 
classe ou a une implementation d'interface. 

On peut aussi imposer 1' implementation de plusieurs interfaces, comme dans : 

class Couple <T extends Comparable & Cloneable > 
{ } // T doit implementer les interfaces Comparable et Cloneable 

Dans ce cas, c'est la premiere interface citee qui sera utilisee par le compilateur en remplace- 
ment du type T ; par exemple, ici : 

• les variables x et y seront declarees de type Comparable, 

• si Ton declare : 

Couple <Double> cd ; 

une expression telle que : 

cd . getPremier ( ) 



5 - Heritage et programmation generique 



593 



sera traduite comme si Ton avait ecrit : 
(Comparable) cd. getPremier ( ) 
Enfin, on peut combiner les deux possibilites : une classe et une ou plusieurs interfaces, 
comme dans : 

class Couple <T extends A & Comparable S Cloneable > 

{ } // T doit deriver de A et implementer les interfaces Comparable et Cloneable 

Dans ce cas, il ne doit y avoir qu'une seule classe (ce qui va de soi puisqu'en Java, une me me 
classe ne peut pas deriver de deux autres) et elle devra etre citee en premier : c'est elle qui 
sera utilisee par le compilateur dans ses traductions. 

En C++ 

C++ ne permet pas d'imposer de limitations aux parametres de type. En revanche, il dis- 
pose de la notion de "specialisation" qui n'existe pas en Java. Celle-ci permet de fournir 
des definitions specialisees pour certaines valeurs des parametres de type. 

5 Heritage et programmation generique 

Comme on peut s'y attendre, il est possible de creer une classe derivee d'une classe gene- 
rique et ceci de differentes manieres, suivant que Ton conserve ou non les parametres de type 
ou que Ton en ajoute de nouveaux. 

Une situation ou semble intervenir l'heritage est celle de deux classes generiques dans les- 
quelles les parametres de type derivent l'un de l'autre comme ce serait par exemple le cas 
dans Couple<Pointcol> et Couple<Point> oil Pointcol derive de Point. En fait, nous verrons 
qu'il n'existe aucune relation d' heritage dans un tel cas, ce qui sera justifie pour d'evidentes 
raisons de securite. Nous verrons cependant dans le paragraphe suivant comment la notion de 
joker permet d'exploiter certaines des proprietes de cette "fausse relation d'heritage". 

5.1 Derivation d'une classe generique 

Disposant d'une classe generique telle que : 

class C <T> { } 

il existe bon nombre de facons d'en creer des classes derivees : 

• La classe derivee conserve les parametres de type de la classe de base, sans en ajouter 
d' autres, comme dans : 

class D <T> extends C <T> { } 

Ici, C et D utilisent le meme parametre de type. Ainsi D<String> derive de C<String>, 
D<Double> derive de C<Double>. II en irait de meme avec : 

class IXT, U> extends C<T, U> 

Ici, D<String, Doublo derive de C<String, Doublo. 
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• La classe derivee utilise les memes parametres de type que la classe de base, en en ajoutant 
de nouveaux, comme dans : 

class D <T, U> extends C <T> { } 

Ici, outre le parametre de type T de C, D possede un parametre supplementaire U. Ainsi, 
D<String, Doulo derive de C<String>, D<Integer, Double> derive de C<Integer> . 

• La classe derivee introduit des limitations sur un ou plusieurs des parametres de type de la 
classe de base, comme dans : 

class D <T extends Number> extends C<1> 

Ici, on peut utiliser D<Double>, qui derive alors de C<Double> ; en revanche, on ne peut 
pas utiliser D<String> (alors qu'on peut utiliser C<String>). 

• La classe de base n'est pas generique, la classe derivee Test, comme dans (on suppose que 
X est une classe) : 

class EK1> extends X 

Ici, X est une classe usuelle. D<String>, D<Double>, D<Point> derivent toutes de X. 

• La classe de base est une instance particuliere d'une classe generique, comme dans : 

class EK1> extends C<String> 

II s'agit en fait d'un cas particulier du cas precedent, dans lequel X est une instance 
particuliere de C<T> (avec T = String). D<Double>, D<Point> et meme D<String> de- 
rivent toutes de C<String>. 

En revanche, ces situations seront incorrectes : 

class D extends C<1> / / erreur : D doit disposer au moins du parametre T 
class G<1> extends C<T extends Number> // erreur 



5.2 Si T derive de T, C<T> ne derive pas de C<T> 

Comme on Fa deja evoque, cette relation entre les classes C<T'> et C<T> n'est pas une 
relation d' heritage. Nous vous proposons de voir pourquoi en considerant une adaptation de 
notre classe Couple precedente, en lui ajoutant une methode nommee SetPremier, permettant 
de modifier la reference au premier element du couple. Notre nouvelle classe, nommee 
Couplel pourrait se presenter ainsi : 
class Couplel<l> 
{ private T x, y ; 

public Couplel (T premier, T second) 

{ x = premier ; y = second ; } 

public T getPremier () { return x ; } 

public void setPremier (T premier) 

{ x = premier ; } 

public void affiche () 

{ System. out .println ("premiere valeur : " + x + " - deuxieme valeur : " + y ) ; ) 

} 
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Supposons ces declarations : 

Object ol, o2 ; 
Integer il, i2 ; 

et considerons alors ces deux instances de Couplel : 

Couplel <Object> co = new Couplel (ol, o2) ; 
Couplel <Integer> ci = new Couplel (il, i2) ; 

Supposons qu'il y ait relation d'heritage entre nos deux classes, c'est-a-dire que 
Couplel <Integer> derive de Couplel <Object> . L' affectation suivante serait alors legale : 

co = ci ; // interdit ; on suppose que cela est possible 

On aboutirait alors a la situation suivante : 



ci 



co 




L' instruction suivante serait alors legale : 

co . setPremier (ol) ; 

et elle conduirait a cette situation : 



ci 



co 




On serait ainsi en presence d'un couple forme de ol (Object) et i2 (Integer), reference a la 
fois par ci et co. L'appel suivant : 

ci . getPremier ( ) ; 

renverrait alors Fobjet ol. II est clair qu'a l'execution une affection telle que celle-ci 
echouerait : 

Integer n = ci . getPremier ( ) ; // affectation Object a Integer : illegale 

Voila pourquoi les concepteurs de Java ont voulu que la relation evoquee ne soit pas conside- 
red comme une vraie relation d'heritage. 
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5.3 Preservation du polymorphisme 

Comme on peut l'esperer, la programmation generique ne remet pas en cause le polymor- 
phisme. Cela va de soi dans des situations telles que celles-ci : 

class A<T> 

{ void £() { } 

} 

class B<1> extends A<T> 

{ void £() { } 

} 

class C<T, U> extends A<T> 

{ void f () { } 

} 



A<Integer> a ; 
B<Integer> b ; 
C<Integer, String> c ; 



a = b ; a.f () ; // appel B.f 
a = c ; a.f () ; // appel C.f 

En revanche, considerons : 

class A<T> 

{ void f (T x) { } 

} 

class B extends A<Integer> 

{ void f (Integer i) { } 

} 



A<Double> ad ; 

A<Integer> ai ; 

B b ; Double d ; Integer i ; 

ad.f (d) ; // appel A.f 

ai.f (i) ; // appel A.f 

ai = b ; 

ai.f (i) ; // appel B.f 
Le polymorphisme est bien respecte dans le dernier cas puisqu'on appelle bien une methode 
de signature /(Integer) appartenant au type de l'objet designe a ce moment la par ai (B). Pour- 
tant, si Ton tient compte de l'effacement, les classes A et B ont ete compilees comme si elles 
avaient ete definies ainsi : 

class A 

{ void f (Object x) { } 

} 

class B extends A 

{ void f (Integer i) { } 

} 

Or, F appel ai.fi i) a ete resolu a la compilation par appel d'une methode de signature 
/(Object). Pour que le polymorphisme fonctionne correctement, le compilateur a en fait 



6 - Les jokers 




genere une methode supplementaire dite souvent "methode bridge" dans B, de signature 
/(Object) jouant le role de /(Integer) : 

void f (Object x) { f ( (Integer) x) ; } // methode bridge ajoutee dans B 



1 Contrairement a l'effacement dont la connaissance etait utile pour comprendre certains 
comportements de la programmation generique, F existence des methodes bridge peut 
etre ignoree des lors qu'on sait que le polymorphisme est garanti en toutes circonstances. 
Encore faut-il ne pas trop reflechir, cette fois, aux consequences de l'effacement ! 

2 Les methodes bridge sont egalement employees pour gerer correctement les situations 
de valeurs de retour covariantes. 



Nous venons de voir que, si T derive de T, C<T'> ne derive pas de C<T>. Cependant, il 
existe une relation interessante entre ces deux classes puisqu'il reste toujours possible d'uti- 
lisr un objet de type C<T'> comme on le ferait d'un objet de type C<T>, pour peu qu'on ne 
cherche pas a en modifier la valeur. Ce n'est, en effet, que dans ce cas, que des problemes 
apparaissent, comme on a pu le voir precedemment. 

Les concepteurs du JDK 5.0 ont propose une demarche qui permet d'exploiter cette relation, 
sans risque de modifications. Elle reside dans l'emploi d'un joker, lequel peut prendre diffe- 
rentes formes : 

• une forme simple, dans laquelle il represente un type quelconque, 

• une forme contrainte, ou le type correspondant est soumis a des limitations. 



Avec notre classe Couple 1<T> precedente, nous pouvons bien entendu definir : 

Couplel<Integer> ci ; 
Couplel<Double> cd ; 

Mais, on peut egalement definir : 

Couplel <?> cq ; // cq designe un couple d' elements d un type quelconque 

Certes, cette declaration ressemble a : 

Couplel <0bject> cql ; 

Mais, la grande difference est que, par exemple, cette affectation devient legale 

cq = cd , // OK : affectation d' un Couplel<Double> a un Couplel<?> 

alors que celle-ci ne le serait pas : 

cql = cd ; // erreur de compilation 

En revanche, il n'est pas possible de modifier l'objet reference par cq : 

cq. setPremier ( ) ; // erreur de compilation 



Remarques 



6 Les jokers 



6.1 Le concept de joker simple 
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Informations complementaires 



En toute rigueur, ce ne sont pas simplement les modifications d'un objet de type 
Couple 1<?> qui sont interdites, mais plus precisement, l'appel de toute methode rece- 
vant un argument du type correspondant a ?. Par exemple, supposons qu'on ait muni 
notre classe Couple 1 d'une methode permettant de comparer le premier element du cou- 
ple a un objet fourni en argument : 

public boolean comparePremier (T tiers) 
{ if (x == tiers) return true ; 

else return false ; 

} 

l'appel suivant serait rejete, alors meme que la methode comparePremier ne modifie 
rien de 1' objet : 

cq . comparePremier (il) ; // erreur de compilation 



6.2 Jokers avec limitations 

On peut imposer des limitations a un joker, comme on le fait pour des parametres de type. 
Ainsi, avec notre classe Couplel precedente nous pouvons definir : 

Couple <Object> co ; 
Couple <Integer> ci ; 

Couple <? extends Number> cqn ; 111 represente un type quelconque derive de Number 

L' affectation suivante sera illegale : 

cqn = co ; // erreur de compilation : Object ne derive pas de Number 

tandis que celle-ci sera legale : 

cqn = ci ; // OK : Integer derive bien de Number 

Bien entendu, la encore, il ne sera pas possible d'appeler, a partir de cqn, une methode modi- 
fiant Fobjet reference. 



0 



Informations complementaires 

II est egalement possible d'imposer a un joker des limitations inverses de celles que nous 
venons d'evoquer, a savoir que la classe correspondante soit ascendante d'une classe don- 
nee. Par exemple, toujours avec notre classe Couplel precedente, et la classe Pointcol 
(derivee de Point) rencontree dans des chapitres anterieurs, on pourra declarer : 

Couplel <? super Pointcol> cqn ; 111 represente une classe quelconque ascendante 

// de Pointcol (ou Pointcol elle-meme) 

Dans ces conditions, avec ces declarations : 

Point p ; 

Couplel <Point> cp ; 
Couplel <Integer> ci ; 
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1' affectation suivante sera rejetee : 

cqn = ci ; // erreur de compilation : Number n' est pas classe ascendante de Pointcol 

tandis que celle-ci sera acceptee : 

cqn = cp ; // OK : Point est classe ascendante de Pointcol 

Mais, alors qu'avec des jokers limites par derivation, il n'etait plus possible de modi- 
fier les objets correspondants, avec des jokers limites par ascendance, il n'est plus pos- 
sible d'acceder aux valeurs des champs de l'objet alors qu'on peut, en revanche, les 
modifier. Plus precisement, ce sont les appels des methodes qui renvoient une valeur du 
type correspondant au joker dont l'appel est interdit. 

6.3 Joker applique a une methode 

Nous avons etudie le concept de joker dans des declarations d'objets generiques. II peut ega- 
lement s'appliquer a des arguments muets d'une methode. 

Supposez qu'on souhaite realiser une methode nommee calcul effectuant des calculs sur les 
elements d'un couple fourni en argument. II est tout a fait possible d' exploiter les jokers en 
ecrivant son en-tete de cette maniere : 

static void calcul (Couple<? extends Number>) 

Cependant, il sera souvent possible d'eviter le recours aux jokers, en utilisant un parametre 
de type, comme dans : 

static <T extends Number> void calcul (Couple<T>) 
On notera cependant que les jokers permettent, non seulement des limitations par heritage, 
mais egalement des limitations par ascendance, ce que n'autorisent pas les parametres de 
type. 
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Les collections 
et les algorithmes 



La version 2 de Java a elargi et harmonise la bibliotheque de classes utilitaires (java.util). On 
y trouve desormais des classes permettant de manipuler les principales structures de donnees, 
c'est-a-dire les vecteurs dynamiques, les ensembles, les listes chainees, les queues et les 
tables associatives. Les concepteurs de cette bibliotheque ont cherche a privilegier la simpli- 
city, la concision, l'homogeneite, 1'universabilite et la fiexibilite. C'est ainsi que les classes 
relatives aux vecteurs, aux listes, aux ensembles et aux queues implementent une meme inter- 
face (Collection) qu'elles completent de fonctionnalites propres. Nous commencerons par 
examiner les concepts communs qu'elles exploitent ainsi : genericite, iterateur, ordonnance- 
ment et relation d'ordre. Nous verrons egalement quelles sont les operations qui leur sont 
communes : ajout ou suppression d'elements, construction a partir des elements d'une autre 
collection... 

Nous etudierons ensuite en detail chacune de ces structures, a savoir : 

• les listes, implementees par la classe LinkedList, 

• les vecteurs dynamiques, implemented par les classes ArrayList et Vector, 

• les ensembles, implemented par les classes HashSet et TreeSet, 

• les queues avec priorite, implementees par la classe PriorityQueue (introduite par le 
JDK 5.0) ; 

• les queues a double entree, implementees par la classe ArrayDeque (introduite par Java 6). 
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Puis nous vous presenterons des algorithmes a caractere relativement general permettant 
d'effectuer sur toutes ou certaines de ces collections des operations telles que la recherche de 
maximum ou de minimum, le tri, la recherche binaire... 

Nous terminerons enfin par les tables associatives qu'il est preferable d'etudier separement 
des autres collections car elles sont de nature differente (notamment, elles n'implementent 
plus l'interface Collection mais 1' interface Map). 



Depuis le JDK 5.0, les collections sont manipulees par le biais de classes generiques imple- 
mentant l'interface Collection<E>, E representant le type des elements de la collection. Tous 
les elements d'une meme collection sont done de meme type E (ou, a la rigueur, d'un type 
derive de E). Ainsi, a une liste chainee LinkedList<String> , on ne pourra pas ajouter des ele- 
ments de type Integer ou Point. 

Avant le JDK 5.0, les collections (qui implementaient alors l'interface Collection) pouvaient 
contenir des elements d'un type objet quelconque. Par exemple, on pouvait theoriquement 
creer une liste chainee (LinkedList) contenant a la fois des elements de type Integer, String, 
Point... En pratique, ce genre de collection heterogene etait peu employe, de sorte que le JDK 
5.0 n'apporte pas de veritable limitation sur ce plan. 

En revanche, avant le JDK 5.0, comme nous le verrons par la suite, Faeces a un element 
d'une collection necessitait systematiquement le recours a l'operateur de cast. Par exemple, 
avec une liste chainee d' elements supposes etre de type String, il fallait employer systemati- 
quement la conversion (String) a chaque consultation. En outre, rien n'interdisait d'introduire 
dans la liste des elements d'un type autre que String avec, a la cle, des risques d'erreur d' exe- 
cution dues a des tentatives de conversions illegales lors d'une utilisation ulterieure de 1' ele- 
ment en question. Depuis le JDK 5.0, la collection etant simplement parametree par le type, 
le recours au cast n'est plus necessaire. En outre, il n'est plus possible d'introduire par 
megarde des elements d'un type different de celui prevu car ces tentatives sont detectees des 
la compilation. 

D'une maniere generate, les modifications apportees par le JDK 5.0 aux collections sont suf- 
fisamment simples pour que nous traitions simultanement l'utilisation des collections avant 
et depuis le JDK 5.0. Ce parallele, complete par les connaissances exposees dans le chapitre 
relatif a la programmation generique, vous permettra, le cas echeant, de combiner des codes 
generiques et des codes non generiques. 

Par souci de simplification, lorsqu'elle sera triviale, la difference entre generique et non 
generique pourra ne pas etre explicitee. Par exemple, au lieu de dire "l'interface 
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Collection<E> {Collection avant le JDK 5.0)", nous dirons simplement "l'interface 
Collection<E>" ou "l'interface Collection>" suivant que E aura ou non un interet dans la 
suite du texte. En revanche, dans les exemples de code, nous ferons toujours la distinction ; 
plus precisement, le code est ecrit de facon generique et des commentaires expriment les 
modifications a apporter pour les versions anterieures au JDK 5.0. 



Dans tous les cas, on ne perdra pas de vue que lorsqu'on introduit un nouvel element dans 
une collection Java, on n'effectue pas de copie de l'objet correspondant. On se contente 
d'introduire dans la collection la reference a l'objet. II est meme permis d'introduire la 
reference null dans une collection (cela n'aurait pas de sens si Ton recopiait effectivement 
les objets). Cette possibility devra toutefois etre evitee, dans la mesure oil elle pourra 
creer des ambiguites lorsque Ton aura affaire a des methodes susceptibles de renvoyer la 
valeur null pour indiquer un deroulement anormal. 



Par nature, certaines collections, comme les ensembles, sont depourvues d'un quelconque 
ordonnancement de leurs elements. D'autres, en revanche, comme les vecteurs dynamiques 
ou les listes chainees voient leurs elements naturellement ordonnes suivant l'ordre dans 
lequel ils ont ete disposes. Dans de telles collections, on pourra toujours parler, a un instant 
donne, du premier element, du deuxieme, ... du nieme, du dernier. 

Independamment de cet ordre naturel, on pourra, dans certains cas, avoir besoin de classer les 
elements a partir de leur valeur. Ce sera par exemple le cas d'un algorithme de recherche de 
maximum ou de minimum ou encore de tri. Lorsqu'il est necessaire de disposer d'un tel 
ordre sur une collection, les methodes concernees considerent par defaut que ses elements 
implementent l'interface Comparable {Comparable <E> depuis le JDK 5.0) et recourent a sa 
methode compareTo 1 . Mais il est egalement possible de fournir a la construction de la collec- 
tion ou a 1' algorithme concerne une methode de comparaison appropriee par le biais de ce 
qu'on nomme un objet comparateur. 



Bien que les ensembles soient des collections fheoriquement non ordonnees, nous verrons 
que, pour des questions d'efficacite, leur implementation les agencera de facon a optimi- 
ser les tests d'appartenance d'un element. Mais seul le type TreeSet exploitera les deux 
possibilites decrites ici ; le type HashSet utilisera, quant a lui, une technique de hachage 
basee sur une autre methode hashCode. 



1. L'interface Comparable ne prevoit que cette methode. 




Remarque 



1 .2 Ordre des elements d'une collection 
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Les collections et les algorithmes 

Chapitre 22 

1.2.1 Utilisation de la methode compareTo 

Certaines classes comme String, File ou les classes enveloppes (Integer, Float...) implemen- 
tent l'interface Comparable et disposent done d'une methode compareTo. Dans ce cas, cette 
derniere fournit un resultat qui conduit a un ordre qu'on peut qualifier de naturel : 

• ordre lexicographique pour les chaines, les noms de fichier ou la classe Character, 

• ordre numerique pour les classes enveloppes numeriques. 

Bien entendu, si vos elements sont des objets d'une classe E que vous etes amene a definir, 
vous pouvez toujours lui faire implementer l'interface Comparable et definir la methode : 

public int compareTo (E o) // public int compareTo (Object o) < — avant JDK 5.0 

Celle-ci doit comparer l'objet courant (this) a l'objet o recu en argument et renvoyer un entier 
(dont la valeur exacte est sans importance) : 

• negatif si Ton considere que l'objet courant est "inferieur" a l'objet o (au sens de l'ordre 
qu'on veut definir), 

• nul si Ton considere que l'objet courant est egal a l'objet o (il n'est ni inferieur, ni supe- 
rieur), 

• positif si Ton considere que l'objet courant est "superieur" a l'objet o. 



1 Notez bien que, avant le JDK 5.0, l'argument de compareTo etait de type Object. Dans le 
corps de la methode, on etait souvent amene a le convertir dans un type objet precis. II 
pouvait s'averer difficile d'ordonner correctement des collections heterogenes car la 
methode compareTo utilisee n'etait plus unique : son choix decoulait de l'application 
des regies de surdefinition et de polymorphisme. Elle pouvait meme alors differer selon 
que Ton comparait ol a o2 ou o2 a ol. 

2 Faites bien attention a ce que la methode compareTo definisse convenablement une 
relation d'ordre. En particulier si ol < o2 et si o2 < o3, il faut que ol < o3. 

3 Si vous oubliez d'indiquer que la classe de vos elements implemente l'interface Com- 
parable<E> (Comparable avant le JKD5.0), leur methode compareTo ne sera pas appe- 
lee car les methodes comparent des objets de "type Comparable<E>" . 

1.2.2 Utilisation d'un objet comparateur 

II se peut que la demarche precedente (utilisation de compareTo) ne convienne pas. Ce sera 
notamment le cas lorsque : 

• les elements sont des objets d'une classe existante qui n'implemente pas l'interface Compa- 
rable, 

• on a besoin de definir plusieurs ordres differents sur une meme collection. 





Remarques 
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II est alors possible de definir l'ordre souhaite, non plus dans la classe des elements mais : 

• soit lors de la construction de la collection, 

• soit lors de l'appel d'un algorithme. 

Pour ce faire, on fournit en argument (du constructeur ou de Falgorithme) un objet qu'on 
nomme un comparateur. II s'agit en fait d'un objet d'un type implementant Pinterface Com- 
parator<E> 1 (ou Comparator avant le JDK 5.0) qui comporte une seule methode : 

public int compare (E ol, E o2) // depuis le JDK 5.0 

public int compare (Object ol, Object o2) // avant le JDK 5.0 

Celle-ci doit done cette fois comparer les objets ol et o2 recus en argument et renvoyer un 
entier (dont la valeur exacte est sans importance) : 

• negatif si Pon considere que ol est inferieur a o2, 

• nul si Ton considere que ol est egal a o2, 

• positif si Ton considere que ol est superieur a o2. 

Notez qu'un tel objet qui ne comporte aucune donnee et une seule methode est souvent 
nomme objet fonction. On pourra le creer par new et le transmettre a la methode concernee. 
On pourra aussi utiliser directement une classe anonyme. Nous en rencontrerons des exem- 
ples par la suite. 

1 .3 Egalite d'elements d'une collection 

Toutes les collections necessitent de definir l'egalite de deux elements. Ce besoin est evi- 
dent dans le cas des ensembles (HashSet et TreeSet) dans lesquels un meme element ne peut 
apparaitre qu'une seule fois. Mais il existe aussi pour les autres collections ; par exemple, 
meme si elle a parfois peu d'interet, nous verrons que toute collection dispose d'une methode 
remove de suppression d'un element de valeur donnee. 

Cette egalite est, a une exception pres, definie en recourant a la methode equals de l'objet. 
Ainsi, la encore, pour des elements de type String, File ou d'une classe enveloppe, les choses 
seront naturelles puisque leur methode equals se base reellement sur la valeur des objets. En 
revanche, pour les autres, il faut se souvenir que, par defaut, leur methode equals est celle 
heritee de la classe Object. Elle se base simplement sur les references : deux objets differents 
apparaitront toujours comme non egaux (meme s'ils contiennent exactement les memes 
valeurs). Pour obtenir un comportement plus satisfaisant, il faudra alors redefinir la methode 
equals de facon appropriee, ce qui ne sera possible que dans des classes qu'on definit soi- 
meme. 

Par ailleurs, comme nous l'avons deja dit, il est tout a fait possible d'introduire la reference 
null dans une collection. Celle-ci est alors traitee differemment des autres references, afin 
d'eviter tout probleme avec la methode equals. Notamment, la reference null n'apparait egale 



1. Ne confondez pas Comparable et Comparator. 



Les collections et les algorithmes 

Chapitre 22 

qu'a elle-meme. En consequence, un ensemble ne pourra la contenir qu'une seule fois, les 
autres types de collections pouvant la contenir plusieurs fois. 

Enfin, et fort malheureusement, nous verrons qu'il existe une classe (TreeSet) ou l'egalite est 
definie, non plus en recourant a equals, mais a compareTo (ou a un comparateur fourni a la 
construction de la collection). Neanmoins, la encore, les choses resteront naturelles pour les 
elements de type String, File ou enveloppe. 



En pratique, on peut etre amene a definir dans une meme classe les methodes compareTo 
et equals. II faut alors tout naturellement prendre garde a ce qu'elles soient compatibles 
entre elles. Notamment, il est necessaire que compareTo fournisse 0 si et seulement si 
equals fournit true. Cette remarque devient primordiale pour les objets que Ton risque 
d'introduire dans differentes collections (la plupart emploient compareTo par defaut, mais 
TreeSet emploie equals). 



Les iterateurs sont des objets qui permettent de "parcourir" un par un les differents elements 
d'une collection. lis ressemblent a des pointeurs (tels que ceux de C ou C++) sans en avoir 
exactement les memes proprietes. 

II existe deux sortes d' iterateurs : 

• monodirectionnels : le parcours de la collection se fait d'un debut vers une fin ; on ne passe 
qu'une seule fois sur chacun des elements ; 

• bidirectionnels : le parcours peut se faire dans les deux sens ; on peut avancer et reculer a sa 
guise dans la collection. 

1.4.1 Les iterateurs monodirectionnels : I'interface Iterator 
Proprietes d'un iterateur monodirectionnel 

Chaque classe collection dispose d'une methode nommee iterator fournissant un iterateur 
monodirectionnel, c'est-a-dire un objet d'une classe implementant I'interface Iterator<E> 
(Iterator avant le JDK 5.0). Associe a une collection donnee, il possede les proprietes 
suivantes : 

• A un instant donne, un iterateur indique ce que nous nommerons une position courante de- 
signant soit un element donne de la collection, soit la fin de la collection (la position cou- 
rante se trouvant alors en quelque sorte apres le dernier element). Comme on peut s'y 
attendre, le premier appel de la methode iterator sur une collection donnee fournit comme 
position courante, le debut de la collection. 





Remarque 



1.4 



Les iterateurs et leurs methodes 
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• On peut obtenir Fobjet designe par un iterateur en appelant la methode next de l'iterateur, 
ce qui, en outre, avance l'iterateur d'une position. Ainsi deux appels successifs de next four- 
nissent deux objets differents (consecutifs). 

• La methode hasNext de l'iterateur permet de savoir si l'iterateur est ou non en fin de collec- 
tion, c'est-a-dire si la position courante dispose ou non d'une position suivante, autrement 
dit si la position courante designe ou non un element. 

Remarques 

1 Depuis le JDK 5.0, la methode next fournit un resultat de type E. En revanche, avant le 
JDK 5.0, elle fournissait un resultat de type general Object. La plupart du temps, pour 
pouvoir exploiter l'objet correspondant, il fallait effectivement en connaitre le type exact 
et effectuer une conversion appropriee de la reference en question. 

2 De toute evidence, pour pouvoir ne passer qu'une seule fois sur chaque element, l'itera- 
teur d'une collection doit se fonder sur un certain ordre. Dans les cas des vecteurs ou 
des listes, il s'agit bien sur de 1' ordre naturel de la collection. Pour les collections appa- 
remment non ordonnees comme les ensembles, il existera quand meme un ordre 
d' implementation 1 (pas necessairement previsible pour l'utilisateur) qui sera exploite 
par l'iterateur. En definitive, toute collection, ordonnee ou non, pourra toujours etre 
parcourue par un iterateur. 



Canevas de parcours d'une collection 

On pourra parcourir tous les elements d'une collection c<E>, en appliquant ce canevas 



// depuis JDK 5.0 2 
Iterator<E> iter = c. iterator () 
while ( iter . hasNext ( ) ) 
{ E o = iter. next () ; 
// utilisation de o 



// avant JDK 5.0 
Iterator iter = c. iterator () 
while ( iter . hasNext ( ) ) 
{ Ob j ect o = iter . next ( ) ; 
// utilisation de o 



Canevas de parcours d'une collection 

La methode iterator renvoie un objet designant le premier element de la collection s'il existe. 
La methode next fournit 1' element designe par iter et avance l'iterateur a la position suivante. 



1. Nous veiTons qu'il s'agit precisement de l'ordre induit par compareTo (ou un comparateur) pour TreeSet et 
de l'ordre induit par la methode hashCode pour HashSet. 

2. Nous verrons un peu plus loin qu'il est possible dans certains cas de simplifier ce canevas en utilisant la bou- 
cle for... each. 
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Si Ton souhaite parcourir plusieurs fois une meme collection, il suffit de reinitialiser l'itera- 
teur en appelant a nouveau la methode iterator. 

La methode remove de I'interface Iterator 

L' interface Iterator prevoit la methode remove qui supprime de la collection le dernier objet 
renvoye par next . 

Voici par exemple comment supprimer d'une collection c tous les elements verifiant une 
condition : 

// depuis JDK 5.0 // avant JDK 5.0 

Iterator<E> iter = c. iterator)) ; Iterator iter = c. iterator () ; 

while (c . iter .hasNext () ) while (c . iter .hasNext () ) 

{ E = iter . next ( ) ; { Ob j ect o = iter . next ( ) ; 

if (condition) iter . remove ( ) ; if (condition) iter . remove ( ) ; 

} } 



Suppression d'une collection c des elements verifiant une condition 

Notez bien que remove ne travaille pas directement avec la position courante de l'iterateur, 
mais avec la derniere reference renvoyee par next que nous nommerons objet courant. Alors 
que la position courante possede toujours une valeur, l'objet courant peut ne pas exister. 
Ainsi, cette construction serait incorrecte (elle conduirait a une exception 
IllegalStateException) : 

Iterator<E> iter ; // Iterator iter ; <— avant JDK 5.0 

iter = c . iterator ( ) ; 

iter . remove ( ) ; / / incorrect 

En effet, bien que l'iterateur soit place en debut de collection, il n'existe encore aucun ele- 
ment courant car aucun objet n'a encore ete renvoye par next. Pour supprimer le premier 
objet de la collection, il faudra d'abord l'avoir "lu" 1 , comme dans cet exemple oil Ton sup- 
pose qu'il existe au moins un objet dans la collection c : 

Iterator <E> iter ; // Iterator iter ; < — avant JDK 5.0 

iter = c . iterator ( ) ; 

iter. next () ; // se place apres le premier objet 

iter . remove ( ) ; // supprime le premier objet 

On notera bien que I'interface Iterator ne comporte pas de methode d'ajout d'un element a 
une position donnee (c'est-a-dire en general entre deux elements). En effet, un tel ajout n'est 
realisable que sur des collections disposant d' informations permettant de localiser, non seule- 
ment l'element suivant, mais aussi l'element precedent d'un element donne. Ce ne sera le cas 
que de certaines collections seulement, disposant precisement d'iterateurs bidirectionnels. 



1. Ici encore, cette association entre la notion d'iterateur et d'element renvoye par next montre bien qu'un iterateur 
se comporte differemment d'un pointeur usuel. 
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En revanche, nous verrons que toute collection disposera d'une methode d'ajout d'un element a un 
emplacement (souvent sa fin) independant de la valeur d'un quelconque iterateur. C'est d'ailleurs 
cette demarche qui sera le plus souvent utilisee pour creer effectivement une collection. 



Remarques 

1 Nous avons vu que la methode iterator peut etre appelee pour reinitialiser un iterateur. II 
faut alors savoir qu'apres un tel appel, il n'existe plus d' element courant. 

2 La classe Iterator dispose d'un constructeur recevant un argument entier representant 
une position dans la collection. Par exemple, si c est une collection, ces instructions : 

Listlterator <E> it ; // Listlterator it ; < — avant JDK 5.0 

it = c. listlterator (5) ; 

creent 1' iterateur it et l'initialisent de maniere a ce qu'il designe le sixieme element de 
la collection (le premier element portant le numero 0). La encore, on notera bien 
qu'apres un tel appel, il n'existe aucun element courant. Si Ton cherche par exemple a 
appeler immediatement remove, on obtiendra une exception. 

Par ailleurs, cette operation necessitera souvent de parcourir la collection jusqu' a l'ele- 
ment voulu (la seule exception concernera les vecteurs dynamiques qui permettront 
Faeces direct a un element de rang donne). 

Parcours unidirectionnel d une collection avec for... each (JDK 5.0) 

La boucle for... each permet de simplifier le parcours d'une collection c<E>, en procedant 
ainsi : 

for (E o : c) 

{ utilisation de o 

} 

Ici, la variable o prend successivement la valeur de chacune des references des elements de la collec- 
tion. Toutefois, ce schema n'est pas exploitable si Ton doit modifier la collection, en utilisant des 
methodes telles que remove ou add qui se fondent sur la position courante d'un iterateur. 

1.4.2 Les iterateurs bidirectionnels : I'interface Listlterator 

Certaines collections (listes chainees, vecteurs dynamiques) peuvent, par nature, etre parcourues dans 
les deux sens. Elles disposent d'une methode nommee listlterator qui fournit un iterateur 
bidirectionnel. II s'agit, cette fois, d'objet d'un type implementant I'interface Listlterator <E> (derivee 
de lterator<E>). II dispose bien sur des methodes next, hasNext et remove heritees de Iterator. Mais il 
dispose aussi d'autres methodes permettant d'exploiter son caractere bidirectionnel, a savoir : 

• comme on peut s'y attendre, des methodes previous et hasPrevious, complementaires de 
next et hasNext, 

• mais aussi, des methodes d' addition 1 d'un element a la position courante (add) ou de modi- 
fication de l'element courant (set). 




1. En general, une telle operation est plutot nommee insertion. Mais, ici, la methode se nomme add et non insert ! 
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Methodes previous et hasPrevious 

On peut obtenir F element precedant la position courante a Faide de la methode previous de 
l'iterateur, laquelle, en outre, recule l'iterateur sur la position precedente. Ainsi deux appels 
successifs de previous fournissent deux objets differents. 

La methode hasPrevious de l'iterateur permet de savoir si Ton est ou non en debut de collec- 
tion, c'est-a-dire si la position courante dispose ou non d'une position precedente. 

Par exemple, si I est une liste chainee (nous verrons qu'elle est du type LinkedList), voici 
comment nous pourrons la parcourir a l'envers : 

Listlterator <E> iter ; // Listlterator iter ; < — avant JDK 5.0 

iter = 1. listlterator (l.sizeO) ; /* position courante : fin de liste*/ 
while (iter .hasPrevious () ) 

{ E o = iter .previous () ; // Object o=iter. previous () ; < — avant JDK 5.0 

// utilisation de 1' objet courant o 

} 



Remarque 

Un appel a previous annule, en quelque sorte, Taction realisee sur le pointeur par un pre- 
cedent appel a next. Ainsi, cette construction realiserait une boucle infinie : 

iter = 1. listlterator () ; 

E elem ; // Object elem ; < — avant JDK 5.0 

while (iter .hasNext () ) 
{ elem = iter . next ( ) ; 
elem = iter .previous () ; 

} 

Methode add 

L' interface Listlterator prevoit une methode add qui ajoute un element a la position courante 
de l'iterateur. Si ce dernier est en fin de collection, l'ajout se fait tout naturellement en fin de 
collection (y compris si la collection est vide). Si l'iterateur designe le premier element, 
l'ajout se fera avant ce premier element. 

Par exemple, si c est une collection disposant d'un iterateur bidirectionnel, les instructions 
suivantes ajouteront l'element elem avant le deuxieme element (en supposant qu'il existe) : 

ListIterator<E> it ; // Listlterator it ; < — avant JDK 5.0 

it = c. listlterator () ; 

it . next ( ) ; /* premier element = element courant * / 

it . next ( ) ; /* deuxieme element = element courant * / 

it. add (elem) ; /* ajoute elem a la position courante, c'est-a-dire */ 
/* entre le premier et le deuxieme element * / 

On notera bien qu'ici, quelle que soit la position courante, l'ajout par add est toujours possi- 
ble. De plus, contrairement a remove, cet ajout ne necessite pas que l'element courant soit 
defini (il n'est pas necessaire qu'un quelconque element ait deja ete renvoye par next ou pre- 
vious). 
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Par ailleurs, add deplace la position courante apres l'element qu'on vient d'ajouter. Plusieurs 
appels consecutifs de add sans intervention explicite sur l'iterateur introduisent done des ele- 
ments consecutifs. Par exemple, si / est une liste chainee (de type LinkedList) et si Ton 
declare : 

ListIterator<E> it ; // Listlterator it ; < — avant JDK 5.0 

it = 1. Listlterator () ; 

ces deux sequences sont equivalentes : 

iter. add (ell) ; l.add (ell) ; 

iter. add (el2) ; l.add (el2) ; 

iter. add (el3) ; l.add (el3) ; 

Methode set 

L'appel set (elem) remplace par elem l'element courant, e'est-a-dire le dernier renvoye par 
next ou previous, a condition que la collection n'ait pas ete modifiee entre temps (par exem- 
ple par add ou remove). N'oubliez pas que les elements ne sont que de simples references ; la 
modification operee par set n'est done qu'une simple modification de reference (les objets 
concernes n'etant pas modifies). 

La position courante de l'iterateur n'est pas modifiee (plusieurs appels successifs de set, sans 
action sur l'iterateur, reviennent a ne retenir que la derniere modification). 

Voici par exemple comment Ton pourrait remplacer par null tous les elements d'une collec- 
tion c verifiant une condition : 

ListIterator<E> it ; // Listlterator it ; < — avant JDK 5.0 

it = c. listlterator () ; 
while (it.hasNextO ) 

{ E o = it.nextO ; // Object o = it.next() ; <— avant JDK 5.0 

if (condition) it. set (null) ; 

} 

Remarque 

N'oubliez pas que set, comme remove, s'applique a un element courant (et non comme 
add a une position courante). Par exemple, si it est un iterateur bidirectionnel, la sequence 
suivante est incorrecte et provoquera une exception IllegalStateException : 

it . next ( ) ; 
it . remove ( ) ; 
it. set (el) ; 

1.4.3 Les limitations des iterateurs 

Comme on a deja pu le constater, la classe Iterator ne dispose pas de methode d'ajout d'un 
element a un emplacement donne. Cela signifie que la seule fa5on d'ajouter un element a une 
collection ne disposant pas d' iterateurs bidirectionnels, consiste a recourir a la methode add 
(definie par F interface Collection) travaillant independamment de tout iterateur. 
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D'une maniere generale, on peut dire que les methodes de modification d'une collection 
(ajout, suppression, remplacement) se classent en deux categories : 

• celles qui utilisent la valeur d'un iterateur a un moment donne, 

• celles qui sont independantes de la notion d' iterateur. 

Cette dualite imposera quelques precautions ; en particulier, il ne faudra jamais modifier le 
contenu d'une collection (par des methodes de la seconde categorie) pendant qu'on uti- 
lise un iterateur. Dans le cas contraire, en effet, on a aucune garantie sur le comportement 
du programme. 

1 .5 Efficacite des operations sur des collections 

Pour juger de l'efficacite d'une methode d'une collection ou d'un algorithme applique a une 
collection, on choisit generalement la notation dite "de Landau" (0(...)) qui se definit ainsi : 

Le temps t d'une operation est dit en O(x) s 'il existe une constante k telle que, dans tous les 
cas, on ait : t <= kx. 

Comme on peut s'y attendre, le nombre N d'elements d'une collection pourra intervenir. 
C'est ainsi qu'on rencontrera typiquement : 

• des operations en 0(1), c'est-a-dire pour lesquelles le temps est constant (plutot borne par 
une constante, independante du nombre d'elements de la collection) ; on verra que ce sera 
le cas des additions dans une liste ou des ajouts en fin de vecteur ; 

• des operations en O(N), c'est-a-dire pour lesquelles le temps est proportionnel au nombre 
d'elements de la collection ; on verra que ce sera le cas des additions en un emplacement 
quelconque d'un vecteur. 

• des operations en O(LogN)... 

D'une maniere generale, on ne perdra pas de vue qu'une telle information n'a qu'un carac- 
tere relativement indicatif ; pour etre precis, il faudrait indiquer s'il s'agit d'un maximum ou 
d'une moyenne et mentionner la nature des operations concemees. Par exemple, acceder au 
nieme element d'une collection en possedant N, en parcourant ses elements un a un depuis le 
premier, est une operation en 0( i) pour un element donne. En revanche, en moyenne (; etant 
suppose aleatoirement reparti entre 1 et AO, ce sera une operation en 0(N/2), ce qui par 
definition de O est la meme chose que O(N). 

1 .6 Operations communes a toutes les collections 

Les collections etudiees ici implementent toutes au minimum F interface Collection, de sorte 
qu'elles disposent de fonctionnalites communes. Nous en avons deja entrevu quelques unes 
liees a l'existence d'un iterateur monodirectionnel (1' iterateur bidirectionnel n'existant pas 
dans toutes les collections). Ici, nous nous contenterons de vous donner un apercu des autres 
possibilites, sachant que ce n'est que dans l'etude detaillee de chacun des types de collection 
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que vous en percevrez pleinement l'interet. D' autre part, les methodes liees aux collections 
sont recapitulees en annexe G. 

Par ailleurs, on notera bien que cette apparente homogeneite de manipulation par le biais de 
methodes de meme en-tete ne prejuge nullement de l'efficacite d'une operation donnee pour 
un type de collection donne. De meme, certaines fonctionnalites pourront s'averer peu inte- 
ressantes pour certaines collections : par exemple, les iterateurs s'avereront peu usites avec 
les vecteurs dynamiques. 

1.6.1 Construction 

Comme on peut s'y attendre, toute classe collection C<E> dispose d'un constructeur sans 
argument 1 creant une collection vide : 

C<E> c = new C<E>() ; // C c = new C () ; <— avant JDK 5.0 

Elle dispose egalement d'un constructeur recevant en argument une autre collection 
(n'importe quelle classe implementant F interface Collection : liste, vecteur dynamique, 
ensemble) : 



Avant le JDK 5.0, les collections pouvaient etre heterogenes. Aucun controle n'etait rea- 
lise a la compilation concernant les types respectifs des elements de c2 et de c. Depuis le 
JDK 5.0, le type des elements de c doit etre compatible (identique ou derive) avec celui 
des elements de c2. On peut s'en apercevoir en examinant (en annexe G) l'en-tete du 
constructeur correspondant. Par exemple pour C = LinkedList, on trouvera : 

LinkedList (Collection <? extends E> c) 



1.6.2 Operations liees a un iterateur 

Comme mentionne precedemment, toutes les collections disposent d'une methode iterator 
fournissant un iterateur monodirectionnel. On pourra lui appliquer la methode remove pour 
supprimer le dernier element renvoye par next. En revanche, on notera bien qu'il n'existe pas 
de methode generale permettant d'ajouter un element a une position donnee de l'iterateur. 
Une telle operation ne sera realisable qu'avec certaines collections disposant d'iterateurs 
bidirectionnels (Listlteratof) qui, eux, comportent une methode add. 



I* creation d' une collection c2 comportant tous les elements de c * / 
C<E> c2 = new C<E> (c) ; // C c2 = new C (c) ; < 



< — avant JDK 5.0 




Remarque 



1. Bien qu'il s'agisse d'une propriete commune a toute collection, elle ne peut pas etre prevue dans l'interface 
Collection, puisque le nom d'un constructeur est obligatoirement different d'une classe a une autre. 
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1.6.3 Modifications independantes d'un iterateur 

Toute collection dispose d'une methode add (element), independante d'un quelconque itera- 
teur, qui ajoute un element a la collection. Son emplacement exact dependra de la nature de la 
collection : en fin de collection pour une liste ou un vecteur ; a un emplacement sans impor- 
tance pour un ensemble. 

Par exemple, quelle que soit la collection c<String> (ou c, avant le JDK 5.0), les instructions 
suivantes y introduiront les objets de type String du tableau t : 

String t[ ] = { "Java", "C++", "Basic", "JavaScript"} ; 

for (String s : t) c.add(s) ; 

// for (int i=0 ; i<t. length ; i++) c.add (t[ i] ) ; < — avant JDK 5.0 

De meme, les instructions suivantes introduiront dans une collection c<Integer> (ou c avant 
le JDK 5.0) les objets de type Integer obtenus a partir du tableau d'entiers t : 

int t[ ] = { 2, 5, -6, 2, -8, 9, 5} ; 

for (int v : t) c.add (v) ; 

// for (int i=0 ; i<t. length ; i++) c.add (new Integer (t[ i] ) ) ; < — avant JDK 5.0 

La methode add fournit la valeur true lorsque l'ajout a pu etre realise, ce qui sera le cas avec 
la plupart des collections, exception faite des ensembles ; dans ce cas, on obtient la valeur 
false si F element qu'on cherche a ajouter est deja "present" dans l'ensemble (c'est-a-dire s'il 
existe un element qui lui soit egal au sens defini au paragraphe 1.3). 

De la meme facon, toute collection dispose d'une methode remove (element) qui recherche 
un element de valeur donnee (paragraphe 1.3) et le supprime s'il existe en foumissant alors la 
valeur true. Cette operation aura surtout un interet dans les cas des ensembles ou elle possede 
une efficacite en 0(1) ou en 0(Log N). Dans les autres cas, elle devra parcourir tout ou partie 
de la collection avec, done, une efficacite moyenne en O(N). 

1.6.4 Operations collectives 

Toute collection c dispose des methodes suivantes recevant en argument une autre collection 

ca : 

• addAll (ca) : ajoute a la collection c tous les elements de la collection ca, 

• removeAll (ca) : supprime de la collection c tout element apparaissant egal (paragraphe 1.3) 
a un des elements de la collection ca, 

• retainAll (ca) : supprime de la collection c tout element qui n'apparait pas egal (paragraphe 
1.3) a un des elements de la collection ca (on ne conserve done dans c que les elements pre- 
sents dans ca). 
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Remarque 

La encore, comme pour la construction d'une collection a partir d'une autre, aucune res- 
triction ne pesait sur les types des elements de c et de ca avant le JDK 5.0. Depuis le JDK 
5.0, il est necessaire que le type des elements de ca soit compatible (identique ou derive) 
avec celui de c. Ainsi, comme on pourra le voir en Annexe G, l'en-tete de addAU pour une 
collection donnee sera de la forme : 

addAll (Collection <? extends E> c) 

1 .6.5 Autres methodes 

La methode size fournit la taille d'une collection, c'est-a-dire son nombre d' elements tandis 
que la methode isEmpty teste si elle est vide ou non. La methode clear supprime tous les ele- 
ments d'une collection. 

La methode contains (elem) permet de savoir si la collection contient un element de valeur 
egale (paragraphe 1.3) a elem. La encore, cette methode sera surtout interessante pour les 
ensembles oil elle possede une efficacite en 0(1) (pour HashSet) ou en 0(Log N) (pour Tree- 
Set). 

La methode toString est redefinie dans les collections de maniere a fournir une chaine repre- 
sentant au mieux le contenu de la collection. Plus precisement, cette methode toString fait 
appel a la methode toString de chacun des elements de la collection. Dans ces conditions, 
lorsque Ton a affaire a des elements d'un type String ou enveloppe, le resultat reflete bien la 
valeur effective des elements. Ainsi, dans les exemples du paragraphe 1.6.3, la methode to- 
String fournirait les chaines : 

Java C++ Basic JavaScript 
2 5-62-895 

Dans les autres cas, si toString n'a pas ete redefinie, on n'obtiendra que des informations 
liees a l'adresse des objets, ce qui generalement presentera moins d'interet. 

N'oubliez pas que toString se trouve automatiquement appelee dans une instruction print ou 
println. Vous pourrez exploiter cette possibilite pour faciliter la mise au point de vos pro- 
grammes en affichant tres simplement le contenu de toute une collection. Ainsi, toujours avec 
nos exemples du paragraphe 1.6.3, l'instruction 

println ("Collection = " + c) ; 

affichera : 

Collection = Java C++ Basic JavaScript 
Collection =25-62-895 

Enfin, deux methodes nominees to Array permettent de creer un tableau (usuel) d' objets a 
partir d'une collection. 
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1 .7 Structure generale des collections 



> 



Nous venons de voir que toutes les collections implementent F interface Collection et nous en 
avons etudie les principales fonctionnalites. Vous pourrez generalement vous contenter de 
connaitre les fonctionnalites supplementaires qu'offrent chacune des classes LinkedList, 
ArrayList, Vector, HashSet, TreeSet, PriorityQueue et ArrayDeque. Mais, dans certains cas, 
vous devrez avoir quelques notions sur 1' architecture d'interfaces employee par les concep- 
teurs de la bibliotheque. Elle se presente comme suit : 

Collection 

List implemented par LinkedList, ArrayList et Vector 

Set implemented par HashSet 

SortedSet implemented par TreeSet 

NavigableSet implemented par TreeSet (Java 6) 

Queue (JDK 5.0) implemented par LinkedList, PriorityQueue 

Deque (Java 6) implemented par ArrayDeque, LinkedList 

Vous verrez que le polymorphisme d'interfaces sera utilise dans certains algorithmes. Par 
exemple, a un argument de type List pourra correspondre n'importe quelle classe implemen- 
tant F interface List, done LinkedList, ArrayList ou Vector mais aussi une classe que vous 
aurez creed. 

Dans certains cas, vous pourrez utiliser ou rencontrer des instructions exploitant ce polymor- 
phisme d'interfaces : 

List<E> 1 ; // List 1 ; <— avant JDK 5.0 

/* 1 pourra etre n' importe quelle collection * / 
/* implementant 1' interface List * / 
Collection cl<E> ; // Collection cl ; < — avant JDK 5.0 

cl = new LinkedList<E> () ; // cl = new LinkedList () ; < — avant JDK 5.0 

/* OK mais on ne pourra appliquer a cl */ 
/* que les methodes prevues dans 1' interface Collection * / 

Une telle demarche presente l'avantage de specifier le comportement general d'une collec- 
tion, sans avoir besoin de choisir immediatement son implementation effective. Mais elle a 
quand meme des limites, dans la mesure ou certaines implementations d'une interface don- 
nee disposent de methodes qui leur sont spedifiques et qui ne sont done pas prevues dans 
1' interface qu'elles implementent. II n'est alors pas possible d'y faire appel. 

Remarque 

Les methodes de la plupart des collections sont "non synchroniseds", ce qui leur confere 
une certaine efhdacite. En contrepartie, il n'est pas possible de les utiliser telles quelles 
dans des threads qui effectueraient des acces "concurrents" a une meme collection. Mais, 
il est possible de definir ce que Ton nomme des "enveloppes synchroniseds" que nous etu- 
dierons a la fin de ce chapitre. D'autre part, il existe en fait d'autres collections synchroni- 
seds figurant dans le paquetage java.util.concurrent que nous n'etudierons pas ici. 
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2 Les listes chaTnees - classe LinkedList 

2.1 Generates 

La classe LinkedList perniet de manipuler des listes dites "doublement chainees". A chaque 
element de la collection, on associe (de facon totalement transparente pour le programmeur) 
deux informations supplementaires qui ne sont autres que les references a F element prece- 
dent et au suivant 1 . Une telle collection peut ainsi etre parcourue a l'aide d'un iterateur bidi- 
rectionnel de type Listlterator (presente au paragraphe 1 .4). 

Le grand avantage d'une telle structure est de permettre des ajouts ou des suppressions a une 
position donnee avec une efficacite en 0(1) (ceci grace a un simple jeu de modification de 
references). 

En revanche, Faeces a un element en fonction de sa valeur ou de sa position dans la liste sera 
peu efficace puisqu'il necessitera obligatoirement de parcourir une partie de la liste. L effica- 
cite sera done en moyenne en O(N). 

2.2 Operations usuelles 
Construction et parcours 

Comme toute collection, une liste peut etre construite vide ou a partir d'une autre 
collection c : 

/* creation d' une liste vide * / 
LinkedList<E> 11 = new LinkedList<E> () ; 

// LinkedList ll=new LinkedList () ; < — avant JDK 5.0 
/* creation d' une liste f ormee de tous les elements de la collection c * / 
LinkedList<E> 12 = new LinkedList<E> (c) ; 

// LinkedList 12 = new LinkedList (c) ; < — avant JDK 5.0 

D'autre part, comme nous Favons deja vu, la methode listlterator fournit un iterateur bidirec- 
tionnel dote des methodes next, previous, hasNext, hasPrevious, remove, add et set decrites 
au paragraphe 1.4.2. En outre, la classe LinkedList dispose des methodes specifiques getFirst 
et getLast fournissant respectivement le premier ou le dernier element de la liste. 

Ajout d'un element 

La methode add de Listlterator (ne la confondez pas avec celle de Collection) permet d'ajou- 
ter un element a la position courante, avec une efficacite en 0(1 ) : 



1 . En toute rigueur, les elements d'une telle liste sont, non plus simplement les references aux objets correspon- 
dents, mais des objets appeles souvent nceuds formes de trois references : la reference a l'objet, la reference au 
nceud precedent et la reference au noeud suivant. En pratique, nous n'aurons pas a nous preoccuper de cela. 
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LinkedList <E> 1 ; // LinkedList 1 ; < — avant JDK 5.0 

Listlterator <E> iter ; // Listlterator iter ; < — avant JDK 5.0 

iter = 1. listlterator () ; /* iter designe initialement le debut de la liste */ 

/* actions eventuelles sur i" iterateur (next et/ou previous) */ 
iter. add (elem) ; /* ajoute 1' element elem a la position courante */ 

Rappelons que la "position courante" utilisee par add est toujours definie : 

• si la liste est vide ou si Ton n'a pas agit sur F iterateur, l'ajout se fera en debut de liste, 

• si hasNext vaut false, l'ajout se fera en fin de liste. 

On notera bien que l'efficacite en 0(1) n'est effective que si Fiterateur est convenablement 
positionne. Si Ton cherche par exemple a ajouter un element en nieme position, alors que 
1' iterateur est "ailleurs", il faudra probablement parcourir une partie de la liste (k elements) 
pour que Foperation devienne possible. Dans ce cas, l'efficacite ne sera plus qu'en O(k). 

La classe LinkedList dispose de methodes specifiques aux listes addFirst et addLast qui ajou- 
tent un element en debut ou en fin de liste avec une efficacite en 0(1). 

Bien entendu, la methode add prevue dans l'interface Collection reste utilisable. Elle se con- 
tente d'ajouter l'element en fin de liste, independamment d'un quelconque iterateur, avec une 
efficacite en 0(1). 

N'oubliez pas qu'il ne faut pas modifier la collection pendant qu'on utilise Fiterateur (voir 
paragraphe 1.4.3). Ainsi le code suivant est a eviter : 

while (iter.hasNex() ) 
{ ... 

if (...) l.add (elem) ; // deconseille : iterateur en cours cF utilisation 

else 1. addFirst (elem) ; // idem 
iter . next ( ) ; 

} 

Suppression d'un element 

Nous avons deja vu que la methode remove de Listlterator supprime le dernier element ren- 
voye soit par next, soit par previous. Son efficacite est en 0(1). 

La classe LinkedList dispose en outre de methodes specifiques removeFirst et removeLast qui 
suppriment le premier ou le dernier element de la liste avec une efficacite en 0(1). 

On peut aussi, comme pour toute collection, supprimer d'une liste un element de valeur don- 
nee (au sens du paragraphe 1.3) avec remove (element). Cette fois l'efficacite sera en O(i), i 
etant le rang de l'element correspondant dans la liste (done en moyenne en O(N)). En effet, 
etant donne qu'il n'existe aucun ordre lie aux valeurs, il est necessaire d' explorer la liste 
depuis son debut jusqu'a la rencontre eventuelle de l'element. La methode remove fournit 
false si la valeur cherchee n'a pas ete trouvee. 
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2.3 Exemples 
Exemple 1 

Voici un exemple de programme manipulant une liste de chaines (String) qui illustre les prin- 
cipals fonctionnalites de la classe Listlterator. Elle contient une methode affiche, statique, 
affichant le contenu d'une liste recue en argument. 



import java.util.* ; 
public class Listel 

{ public static void main (String args[ ] ) 

{ LinkedList<String> 1 = new LinkedList<String> () ; 

// LinkedList 1 = new LinkedList () ; < — avant JDK 5.0 
System. out. print ("Liste en A : ") ; affiche (1) ; 
l.add ("a") ; l.add ("b") ; // ajouts en fin de liste 
System. out. print ("Liste en B : ") ; affiche (1) ; 

ListIterator<String> it = 1 . listlterator () ; 

// LinkedList 1 = new LinkedList () ; < — avant JDK 5.0 
it. next () ; // on se place sur le premier element 
it. add ("c") ; it. add ("b") ; // et on ajoute deux elements 
System. out. print ("Liste en C : ") ; affiche (1) ; 

it = 1. listlterator () ; 

it. next () ; // on progresse d' un element 

it. add ("b") ; it. add ("d") ; // et on ajoute deux elements 
System. out. print ("Liste en D : ") ; affiche (1) ; 

it = 1 . listlterator (l.sizeO) ; // on se place en fin de liste 
while ( it . hasPrevious ( ) ) // on recherche le dernier b 

{ String ch = it . previous ( ) ; 

// String ch = (String) it . previous ( ) ; < — avant JDK 5.0 

if (ch. equals ("b") ) 

{ it . remove ( ) ; / / et on le supprime 
break ; 

} 

} 

System. out. print ("Liste en E : ") ; affiche (1) ; 



it = 1. listlterator () ; 

it. next () ; it. next () ; // on se place sur le deuxieme element 
it. set ("x") ; // qu' on remplace par "x" 

System. out. print ("Liste en F : ") ; affiche (1) ; 

} 

public static void affiche (LinkedList<String> 1) 

// public static void affiche (LinkedList 1) < — avant JDK 5.0 
{ ListIterator<String> iter = 1 . listlterator (); 

// Listlterator iter = 1 . listlterator (); < — avant JDK 5.0 
while ( iter . hasNext ( ) ) System. out. print ( iter. next () + " ") ; 
System. out. println () ; 

} 

1 
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Liste en A : 

Liste en B : a b 

Liste en C : a c b b 

Liste en D : abdcbb 

Liste en E : a b d c b 

Liste en F : a x d c b 

Utilisation d'une liste de chaines (String) 

Remarques 

1 Ici, nous aurions pu nous passer de la methode affiche en utilisant implicitement la 
methode toString de la classe LinkedList dans un appel de print, comme par exemple : 

System. out. println ("Liste en E : " + 1) ; 

au lieu de : 

System. out. print ("Liste en E : ") ; affiche (1) ; 

L'affichage aurait ete presque le meme : 

Liste en E : [ a b d c b] 

2 On pourrait penser a remplacer : 

it = l.listlterator () ; 

it . next () ; it . next ( ) ; / / on se place sur le deuxieme element 
it. set ("x") ; // qu' on remplace par "x" 

par : 

it = l.listlterator (2) ; 

it. set ("x") ; // erreur, il n' y a plus o* element courant 

Cela n'est pas possible car apres 1' initialisation de it, l'element courant n'est pas defini. 
En revanche (bien que cela ait peu d'interet ici), on pourrait proceder ainsi : 

it = l.listlterator (1) ; 

next ( ) ; 

it. set ("x") ; 

Exemple 2 

Voici un exemple montrant comment utiliser une liste chainee pour afficher a l'envers une 
suite de chaines lues au clavier. 



import java.util.* ; 
public class Liste2 

{ public static void main (String args[ ] ) 

{ LinkedList<String> 1 = new LinkedList<String> () ; 

// LinkedList 1 = new LinkedList () ; < — avant JDK 5.0 
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/* on ajoute a la liste tous les mots lus au clavier */ 

System. out. println ("Donnez une suite de mots (vide pour finir)") ; 

while (true) 

{ String ch = Clavier. lireStringO ; 
if (ch. length () == 0) break ; 
l.add (ch) ; 

} 

System. out. println ("Liste des mots a 1' endroit :") ; 
ListIterator<String> iter = 1 . listlterator () ; 

// Listlterator iter = 1 . listlterator () ; <— avant JDK 5.0 
while ( iter . hasNext ( ) ) System. out. print ( iter. next () + " ") ; 
System. out. println () ; 

System . out . println ("Liste des mots a 1' envers :") ; 
iter = 1 . listlterator (1 . size () ) ; // iterateur en fin de liste 
while (iter.hasPrevious () ) System . out . print (iter .previous () + " ") ; 
System. out. println () ; 

} 

} 

Donnez une suite de mots (vide pour finir) 

Java 

C++ 

Basic 

JavaScript 

Pascal 

Liste des mots a 1' endroit : 
Java C++ Basic JavaScript Pascal 
Liste des mots a 1' envers : 
Pascal JavaScript Basic C++ Java 

Inversion de mots 

Remarque 

Ici, il n'est pas possible d'utiliser la methode toString de la liste pour l'afficher a l'envers. 

2.4 Autres possibilites peu courantes 

L'interface List (implementee par LinkedList, mais aussi par ArrayList) dispose encore 
d' autres methodes permettant de manipuler les elements d'une liste a la maniere de ceux d'un 
vecteur, c'est-a-dire a partir de leur rang ; dans la liste. Mais alors que l'efficacite de ces 
methodes est en 0(1) pour les vecteurs dynamiques, elle n'est qu'en O(N) en moyenne pour 
les listes ; elles sont done generalement peu utilisees. Vous en trouverez la description a 
1' annexe G. A simple titre indicatif, mentionnons que vous pourrez : 

• supprimer le nieme element par remove ( i), 

• obtenir la valeur du nieme element par get( i), 
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• modifier la valeur du nieme element par set (i, elem). 

De meme, il existe d'autres methodes basees sur une position, toujours en O(N) (mais, cette 
fois, elles ne font pas mieux avec les vecteurs !) : 

• aj outer un element en position i par add(i, elem), 

• obtenir le rang du premier ou du dernier element de valeur (equals) donnee par indexOf 
(elem) ou lastlndexOf (elem), 

• ajouter tous les elements d'une autre collection c a un emplacement donne par addAll (i, c). 

2.5 Methodes introduites par Java 5 et Java 6 

Depuis le JDK 5.0, la classe LinkedList implemente egalement l'interface Queue. On y 
trouve alors une methode d'ajout (offer) qui, contrairement a add, ne declenche pas d'excep- 
tion en cas de pile pleine. On y trouve egalement des methodes de consultation destructive 
(poll) ou non destructive (peek), qui font double emploi avec getFirst et removeFirst (qui 
appartiennent a la classe LinkedList, mais pas a l'interface List). 

Depuis Java 6, la classe LinkedList implemente en outre l'interface Deque (queue a double 
entree) presentee plus loin. Elle se trouve alors dotee d'un jeu complet de methodes d'action 
soit en debut, soit en fin de liste (ajout, consultation destructive ou non), avec, en plus, la pos- 
sibility de choisir le comportement en cas d'anomalie (soit exception, soit valeur de retour 
particuliere). La encore, ces methodes font double emploi avec getFirst, getLast, removeFirst 
et removeLast (qui appartiennent a la classe LinkedList, mais pas a l'interface List). 

Les interfaces Queue et Deque sont presentees aux paragraphes 5 et 6. 

3 Les vecteurs dynamiques - classe ArrayList 

3.1 Generates 

La classe ArrayList offre des fonctionnalites d'acces rapide comparables a celles d'un 
tableau d'objets. Bien qu'elle implemente, comme LinkedList, l'interface List, sa mise en 
ceuvre est differente et prevue pour permettre des acces efficaces a un element de rang donne, 
c'est-a-dire en 0(1) (on parle parfois d'acces direct a un element comme dans le cas d'un 
tableau). 

En outre, cette classe offre plus de souplesse que les tableaux d'objets dans la mesure oil sa 
taille (son nombre d' elements) peut varier au fil de 1' execution (comme celle de n'importe 
quelle collection). 

Mais pour que Faeces direct a un element de rang donne soit possible, il est necessaire que 
les emplacements des objets (plutot de leurs references) soient contigus en memoire (a la 
maniere de ceux d'un tableau). Aussi cette classe souffrira d'une lacune inherente a sa 
nature : l'addition ou la suppression d'un objet a une position donnee ne pourra plus se faire 
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en 0(1) comme dans le cas d'une liste 1 , mais seulement en moyenne en O(N). En definitive, 
les vecteurs seront bien adaptes a Faeces direct a condition que les additions et les suppres- 
sions restent limitees. 

Par ailleurs, cette classe dispose de methodes permettant de controler F emplacement alloue a 
un vecteur a un instant donne. 

3.2 Operations usuelles 
Construction 

Comme toute collection, un vecteur dynamique peut etre construit vide ou a partir d'une 
autre collection c : 

/* vecteur dynamique vide * / 
ArrayList <E> vl = new ArrayList <E> () ; 

// ArrayList vl = new ArrayList () ; < — avant JDK 5.0 
/* vecteur dynamique contenant tous les elements de la collection c * / 
ArrayList <E> v2 = new ArrayList <E> (c) ; 

// ArrayList v2 = new ArrayList (c) ; < — avant JDK 5.0 

Ajout d'un element 

Comme toute collection, les vecteurs disposent de la methode add (elem) qui se contente 
d'ajouter Felement elem en fin de vecteur avec une efficacite en 0(1). 

On peut aussi ajouter un element elem en un rang i donne a Faide de la methode add (i,elem) 

Dans ce cas, le nouvel element prend la place du nieme, ce dernier et tous ses suivants etant 
decales d'une position. L' efficacite de la methode est done en 0(N-i), soit en moyenne en 
O(N). 

Suppression d'un element 

La classe ArrayList dispose d'une methode specifique remove permettant de supprimer un 
element de rang donne (le premier element est de rang 0, comme dans un tableau usuel). Elle 
fournit en retour Felement supprime. La encore, les elements suivants doivent etre decales 
d'une position. L efficacite de la methode est done en 0(N-i) ou O(N) en moyenne. 

ArrayList <E> v ; // ArrayList v ; < — avant JDK 5.0 



/* suppression du troisieme element de v qu' on obtient dans o * / 
E o = v. remove (3) ; // Object o = v. remove (3) ; < — avant JDK 5.0 

On ne confondra pas cette methode remove de ArrayList avec la methode remove d'un itera- 
teur (rarement utilise avec les vecteurs). 



1 . Dans le cas de l'insertion a la position courante car l'insertion en un rang donne aurait elle aussi une efficacite 
moyenne en O(N). 
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On peut aussi (comme pour toute collection) supprimer d'un vecteur un element de valeur 
donnee elem (comme defini au paragraphe 1.3) avec remove (elem). L'efficacite est en O(i) 
(i etant le rang de 1' element correspondant dans le vecteur), done la encore en moyenne en 
O(N). En effet, etant donne qu'il n'existe aucun ordre lie aux valeurs, il est necessaire 
d'explorer le vecteur depuis son debut jusqu'a l'eventuelle rencontre de l'element. La 
methode remove fournit/a/se si la valeur cherchee n'a pas ete trouvee. 

La classe ArrayList possede une methode specifique removeRange permettant de supprimer 
plusieurs elements consecutifs (de nap) : 

ArrayList <E> v ; // ArrayList v ; < — avant JDK 5.0 

v. removeRange (3, 8) ; // supprime les elements de rang 3 a 8 de v 

Acces aux elements 

Ce sont precisement les methodes d' acces ou de modification d'un element en fonction de sa 
position qui font tout l'interet des vecteurs dynamiques puisque leur efficacite est en 0(1). 

On peut connaitre la valeur d'un element de rang i par get(i). Generalement, pour parcourir 
tous les elements de type E d'un vecteur v, on procedera ainsi : 



Voici par exemple une methode statique recevant un argument de type ArrayList et en affi- 
chant tous les elements, d'abord dans une version generique (depuis le JDK 5.0) : 

public <E> static void affiche (ArrayList <E> v) 
{ for (E e : v) 

System. out. print (e + " ") ; 
System. out. println () ; 

} 

ou dans une version anterieure au JDK 5.0 : 

public static void affiche (ArrayList v) 
{ for (int i = 0 ; Kv.sizeO ; i++) 

System. out. print (v.get(i) + " ") ; 
System. out. println () ; 

} 

On peut remplacer par elem la valeur de l'element de rang i par set (i, elem). Voici par exem- 
ple comment remplacer par la reference null tout element d'un vecteur dynamique v verifiant 
une condition : 

for (int i = 0 ; Kv.sizeO ; i++) // for... each pas utilisable ici 
if (condition) set (i, null) ; 

Comme d'habitude, la methode set fournit la valeur de l'element avant modification. 




// depuis le JDK 5.0 
for (E e : v) 

{ // utilisation de e 



// avant JDK 5.0 
for (int i=0 ; Kv.sizeO ; 
{ // utilisation de v.get(i) 



i++) 
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La classe ArrayList implemente elle aussi Finterface List et, a ce titre, dispose d'un itera- 
teur bidirectionnel qu'on peut theoriquement utiliser pour parcourir les elements d'un 
vecteur. Toutefois, cette possibility fait double emploi avec Faeces direct par get ou set 
auquel on recourra le plus souvent. En revanche, elle sera implicitement utilisee lors d'un 
parcours par la boucle/or... each. 



Voici un programme creant un vecteur contenant dix objets de type Integer, illustrant les 
principales fonctionnalites de la classe ArrayList : 

import java.util.* ; 
public class Arrayl 

{ public static void main (String args[ ] ) 

{ ArrayList <Integer> v = new ArrayList <Integer> () ; 



System. out. println ("En A : taille de v = " + v.sizeO ) ; 

/* on ajoute 10 objets de type Integer */ 
for (int i=0 ; i<10 ; i++) v. add (new Integer (i) ) ; 
System. out. println ("En B : taille de v = " + v.sizeO ) ; 

/* affichage du contenu, par acces direct (get) a chague element */ 
System. out. println ("En B : contenu de v = ") ; 

for (Integer e : v) // for (int i = 0 ; Kv.sizeO ; i++) < — avant JDK 5.0 

System. out. print (e + " ") ; // System. out. print (v.get(i)+" ") ; < — 

System. out. println () ; 

/* suppression des elements de position donnee * / 
v . remove ( 3 ) ; 
v . remove ( 5 ) ; 
v . remove ( 5 ) ; 

System. out. println ("En C : contenu de v = " + v) ; 

/* ajout cf elements a une position donnee */ 
v.add (2, new Integer (100)) ; 
v.add (2, new Integer (200)) ; 

System. out. println ("En D : contenu de v = " + v) ; 

/* modification d' elements de position donnee * / 
v.set (2, new Integer (1000)) ; // modification element de rang 2 
v.set (5, new Integer (2000)) ; // modification element de rang 5 
System. out. println ("En D : contenu de v = " + v) ; 



3.3 Exemple 



// ArrayList v = new ArrayList () 



< — avant JDK 5.0 
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En A : taille de v = 0 

En B : taille de v = 10 

En B : contenu de v = 
0123456789 

En C : contenu de v = [ 0, 1, 2, 4, 5, 8, 9] 

En D : contenu de v = [ 0, 1, 200, 100, 2, 4, 5, 8, 9] 

En D : contenu de v = [ 0, 1, 1000, 100, 2, 2000, 5, 8, 9] 

Utilisation d'un vecteur dynamique d' elements de type Integer 



3.4 Gestion de I'emplacement d'un vecteur 

Lors de sa construction, un objet de type ArrayList dispose d'une "capacite" c, c'est-a-dire 
d'un nombre d' emplacements memoire contigus permettant d'y stocker c elements. Cette 
capacite peut etre definie lors de l'appel d'un constructeur ou fixee par defaut. Elle ne doit 
pas etre confondue avec le nombre d'elements du vecteur, lequel est initialement nul. 

Au fil de l'execution, il peut s'averer que la capacite devienne insuffisante. Dans ce cas, une 
nouvelle allocation memoire est faite avec une capacite incrementee d'une quantite fixee a la 
construction ou doublee si rien d'autre n'est specifie. Lors de l'accroissement de la capacite, 
il se peut que les nouveaux emplacements necessaires ne puissent pas etre alloues de facon 
contigue aux emplacements existants (il en ira souvent ainsi). Dans ce cas, tous les elements 
du tableau devront etre recopies dans un nouvel emplacement, ce qui prendra un certain 
temps. 

Par ailleurs, on disposera de methodes permettant d'ajuster la capacite au fil de l'execution : 

• ensureCapacity (capaciteMini) : demande d'allouer au vecteur une capacite au moins egale 
a capaciteMini ; si la capacite est deja superieure, l'appel n'aura aucun effet ; 

• trimToSize( ) : demande de ramener la capacite du vecteur a sa taille actuelle en liberant les 
emplacements memoire non utilises ; ceci peut s'averer interessant lorsqu'on sait que la 
taille de la collection ne changera plus par la suite. 

3.5 Autres possibilites peu usuelles 

La classe ArrayList dispose encore de quelques methodes peu usitees. Vous en trouverez la 
liste en annexe G. 

Par ailleurs, comme ArrayList implemente l'interface List, elle dispose encore de quelques 
methodes permettant : 

• d'obtenir le rang du premier ou du dernier element de valeur donnee (voir paragraphe 1.3) 
par indexOf (elem) ou lastlndexOf (elem), 

• d'ajouter tous les elements d'une autre collection c a un emplacement donne i par addAll (i, c). 
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3.6 L'ancienne classe Vector 

Dans les versions anterieures a la version 2.0, Java ne disposait pas des collections que nous 
venons de decrire ici. En revanche, on y trouvait une classe nommee Vector permettant, 
comme ArrayList de manipuler des vecteurs dynamiques. Elle a ete remaniee dans la 
version 2 de Java, de facon a implementer l'interface List ; elle peut done etre utilisee comme 
une collection (vous trouverez la liste des methodes de Vector en annexe G). 

Comme nous l'avons dit, la plupart des collections sont "non synchronisees", autrement dit 
leurs methodes n'ont jamais le qualificatif synchronized. Deux threads differents ne peuvent 
done pas acceder sans risque a une meme collection. En revanche, la classe Vector est "syn- 
chronisee". Cela signifie que deux threads differents peuvent acceder au meme vecteur, mais 
au prix de temps d'execution plus longs qu'avec la classe ArrayList. 

Mais nous verrons qu'il est possible de definir des "enveloppes synchronisees" des collec- 
tions, done en particulier d'un vecteur ArrayList qui jouera alors le meme role que Vector. De 
plus, le paquetage java.util.concurent propose des collections synchronisees (que nous n'etu- 
dierons pas ici). En definitive, il est utile de connaitre cette classe Vector car elle a ete fort uti- 
lisee dans d'anciens codes... 

Remarques 

1 La classe Vector dispose d'une methode capacity qui fournit la capacite courante d'une 
collection ; curieusement, ArrayList ne possede pas de methode equivalente. 

2 Les versions anterieures de Java disposaient encore d'autres classes qui restent toujours 
utilisables mais dont nous ne parlons pas dans cet ouvrage. Citons : Enumeration 
(jouant le meme role que les iterateurs), Stack (pile), HashTable (jouant le meme role 
que HashMap etudie plus loin). 

4 Les ensembles 

4.1 Generates 

Deux classes implementent la notion d'ensemble : HashSet et TreeSet. Rappelons que, theo- 
riquement, un ensemble est une collection non ordonnee d'elements, aucun element ne pou- 
vant apparaitre plusieurs fois dans un meme ensemble. Chaque fois qu'on introduit un nouvel 
element dans une collection de type HashSet ou TreeSet, il est done necessaire de s' assurer 
qu'il n'y figure pas deja, autrement dit que l'ensemble ne contient pas un autre element qui 
lui soit egal (au sens defini au paragraphe 1.3). Nous avons vu que des que Ton s'ecarte 
d'elements de type String, File ou enveloppe, il est generalement necessaire de se preoccuper 
des methodes equals ou compareTo (ou d'un comparateur) ; si on ne le fait pas, il faut accep- 
ter que deux objets de references differentes ne soient jamais identiques, quelles que soient 
leurs valeurs ! 
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Par ailleurs, bien qu'en theorie un ensemble ne soit pas ordonne, des raisons evidentes d' effi- 
cacite des methodes de test d'appartenance necessitent une certaine organisation de l'infor- 
mation. Dans le cas contraire, un tel test d'appartenance ne pourrait se faire qu'en examinant 
un a un les elements de l'ensemble (ce qui conduirait a une efficacite moyenne en O(N)). 
Deux demarches differentes ont ete employees par les concepteurs des collections, d'oii 
l'existence de deux classes differentes : 

• HashSet qui recourt a une technique dite de hachage, ce qui conduit a une efficacite du test 
d'appartenance en 0(1), 

• TreeSet qui utilise un arbre binaire pour ordonner completement les elements, ce qui conduit 
a une efficacite du test d'appartenance en 0(Log N). 

En definitive, dans les deux cas, les elements seront ordonnes meme si cet ordre est moins 
facile a apprehender dans le premier cas que dans le second (avec TreeSet, il s'agit de 1' ordre 
induit par compareTo ou un eventuel comparateur). 

Dans un premier temps, nous presenterons les fonctionnalites des ensembles dans des situa- 
tions oil leurs elements sont d'un type qui ne necessite pas de se preoccuper de ces details 
d' implementation (String ou enveloppes). 

Dans un deuxieme temps, nous serons amenes a vous presenter succinctement les structures 
reellement utilisees afin de vous montrer les contraintes que vous devrez respecter pour 
induire un ordre convenable, a savoir : 

• definir les methodes hashCode et equals des elements avec la classe HashSet (equals etant 
aussi utilisee pour le test d'appartenance), 

• definir la methode compareTo des elements (ou un comparateur) avec la classe TreeSet (cet- 
te fois, c'est cet ordre qui sera utilise pour le test d'appartenance). 

4.2 Operations usuelles 
Construction et parcours 

Comme toute collection, un ensemble peut etre construit vide ou a partir d'une autre 
collection : 

/ / ensemble vide 

HashSet<E> el = new HashSet<E> () ; // HashSet el = new HashSet () ; < — avant JDK 5.0 

/ / ensemble contenant tous les elements de la collection c 

HashSet<E> e2 = new HashSet<E> (c) ; // HashSet e2 = new HashSet (c) ; <— avant JDK 5.0 

// ensemble vide 

TreeSet<E> e3 = new TreeSet<E>() ; // TreeSet e3 = new TreeSet () ; < — avant JDK 5.0 

// ensemble contenant tous les elements de la collection c 
TreeSet<E> e4 = new TreeSet<E> (c) ; // TreeSet e4 = new TreeSet (c) ; < — avant JDK 5.0 

Les deux classes HashSet et TreeSet disposent de la methode iterator prevue dans F interface 
Collection. Elle fournit un iterateur monodirectionnel (Iterator) permettant de parcourir les 
differents elements de la collection : 
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HashSet<E> e ; // ou TreeSet<E> e 



// HashSet e ; ou TreeSet e ; 



< — avant JDK 5.0 



Iterator<E> it = e. iterator () 
5.0 

while (it.hasNextO ) 
{ E o = it. next () ; 



// Iterator it = e. iterator () 



< — avant JDK 



// Object o = it. next () 



< — avant JDK 5.0 



// utilisation de o 



Ajout d'un element 

Rappelons qu'il est impossible d'ajouter un element a une position donnee puisque les 
ensembles ne disposent pas d'un iterateur bidirectionnel (d'ailleurs, comme au niveau de leur 
implementation, les ensembles sont organises en fonction des valeurs de leurs elements, 
l'operation ne serait pas realisable). 

La seule facon d'ajouter un element a un ensemble est d'utiliser la methode add prevue dans 
l'interface Collection. Elle s'assure en effet que l'element en question n'existe pas deja : 

HashSet<E> e ; E elem ; // Hashset e ; Object elem ; < — avant JDK 5.0 

boolean existe = e.add (elem) ; 

if (existe) System. out. println (elem + " existe deja") ; 

else System. out. println (elem + " a ete ajoute") ; 

Rappelons que grace aux techniques utilisees pour implementer l'ensemble, l'efficacite du 
test d'appartenance est en 0(1 ) pour le type HashSet et en 0(Log N) pour le type TreeSet. 



On ne peut pas dire que add ajoute l'element en "fin d'ensemble" (comme dans le cas des 
collections etudiees precedemment). En effet, comme nous l'avons deja evoque, les 
ensembles sont organises au niveau de leur implementation, de sorte que l'element devra 
quand meme etre ajoute a un endroit bien precis de l'ensemble (endroit qui se concre- 
tisera lorsqu'on utilisera un iterateur). Pour l'instant, on devine deja que cet endroit sera 
impose par l'ordre induit par compareTo (ou un comparateur) dans le cas de TreeSet ; en 
ce qui concerne HashSet, nous le preciserons plus tard. 

Suppression d'un element 

Nous avons vu que pour les autres collections, la methode remove de suppression d'une 
valeur donnee possede une efficacite en O(N). Un des grands avantages des ensembles est 
d'effectuer cette operation avec une efficacite en 0(1) (pour HashSet) ou en OfLog N) (pour 
TreeSet). Ici, la methode remove renvoie true si l'element a ete trouve (et done supprime) et 
false dans le cas contraire : 

TreeSet<E> e ; E o ; // TreeSet e ; Object o ; <— avant JDK 5.0 

boolean trouve = e. remove (o) ; 

if (trouve) System. out. println (o + " a ete supprime") ; 

else System. out. println (o + " n'existe pas ") ; 




Remarque 
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Par ailleurs, la methode remove de l'iterateur monodirectionnel permet de supprimer F ele- 
ment courant (le dernier renvoye par next) le cas echeant : 

TreeSet<E> e ; // TreeSet e ; < — avant JDK 5.0 

Iterator<E> it = e. iterator () ; // Iterator it = e. iterator () ; < — avant JDK 

5.0 

it. next () ; it. next () ; /* deuxieme element = element courant */ 
it . remove ( ) ; /* supprime le deuxieme element * / 

Enfin, la methode contains permet de tester l'existence d'un element, avec toujours une effi- 
cacite en 0(1) ou en O(LogN). 

4.3 Exemple 

Voici un exemple dans lequel on cree un ensemble d' elements de type Integer qui utilise la 
plupart des possibilites evoquees precedemment. La methode statique affiche est surtout des- 
tinee ici a illustrer l'emploi d'un iterateur car on aurait pu s'en passer en affichant directe- 
ment le contenu d'un ensemble par print (avec toutefois, une presentation legerement 
differente). 

import java.util.* ; 
public class Ensl 

{ public static void main (String args[ ] ) 
{ int t[ ] = { 2, 5, -6, 2, -8, 9, 5} ; 

HashSet<Integer>ens = new HashSet<Integer> () ; 

// HashSet ens = new HashSetO ; < — avant JDK 5.0 
/* on ajoute des objets de type Integer */ 
for (int v : t) // for (int i=0 ; i< t. length ; i++) < — avant JDK 5.0 

{ boolean a j oute = ens . add (v) ; 

// boolean ajoute = ens. add (new Integer (t[ i] ) ) ; < — avant JDK 5.0 
if (ajoute) System. out. println (" On ajoute " + v) ; 

// if (ajoute) System, out. println (" On ajoute "+tt i] ) ; < — avant JDK 5.0 
else System. out .println (" " + v + " est deja present") ; 

// else System. out. println (" " + t[ i] + " est deja present") ; < — 

} 

System. out .print ("Ensemble en A = ") ; affiche (ens) ; 

/* on supprime un eventuel objet de valeur Integer (5) */ 
Integer cinq = 5 ; // Integer cinq = new Integer (5) ; < — avant JDK 5.0 

boolean enleve = ens. remove (cinq) ; 

if (enleve) System. out. println (" On a supprime 5") ; 
System. out .print ("Ensemble en B = ") ; affiche (ens) ; 

/* on teste la presence de Integer (5) */ 
boolean existe = ens. contains (cinq) ; 

if (! existe) System. out. println (" On ne trouve pas 5") ; 

} 

public static <E> void affiche (HashSet<E> ens) 

// public static void affiche (HashSet ens) < — avant JDK 5.0 
{ Iterator<E> iter = ens. iterator () ; // Iterator iter = ens. iterator () ; < — 

while (iter .hasNext () ) 

{ System. out. print ( iter. next () + " ") ; 

} 

System. out. println () ; 

} 

) 
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On ajoute 2 

On ajoute 5 

On ajoute -6 

2 est deja present 

On ajoute -8 

On ajoute 9 

5 est deja present 
Ensemble en A = 2 9 -6 -8 5 

On a supprime 5 
Ensemble en B = 2 9 -6 -8 

On ne trouve pas 5 



Utilisation d'un ensemble d 'elements de type Integer 

Remarque 

Nous aurions pu employer le type TreeSet a la place du type HashSet. Le programme 
modifie dans ce sens figure sur le site Web d'accompagnement sous le nom Ensla.java. 
Vous pourrez constater que le classement des elements au sein de F ensemble est different 
(ils sont ranges par valeur croissante). 

4.4 Operations ensemblistes 

Les methodes removeAll, addAll et retainAll, applicables a toutes les collections, vont pren- 
dre un interet tout particulier avec les ensembles oil elles vont beneficier de l'efficacite de 
Faeces a une valeur donnee. Ainsi, si el et e2 sont deux ensembles : 

• el.addAll(e2) place dans el tous les elements presents dans e2. Apres execution, la reunion 
de el et de e2 se trouve dans el (dont le contenu a generalement ete modifie). 

• el. retainAll (e2) garde dans el ce qui appartient a e2. Apres execution, on obtient Inter- 
section de el et de e2 dans el (dont le contenu a generalement ete modifie). 

• el. removeAll (e2) supprime de el tout ce qui appartient a e2. Apres execution, on obtient le 
"complementaire de e2 par rapport a el" dans el (dont le contenu a generalement ete modi- 
fie). 

Exemple 1 

Voici un exemple appliquant ces operations ensemblistes a des ensembles d'elements de type 
Integer. Notez que nous avons du prevoir une methode utilitaire (copie) de recopie d'un 
ensemble dans un autre (il existe un algorithme copy mais il ne s' applique qu'a des collec- 
tions implementant F interface List). 
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import java.util.* ; 
public class EnsOp 

{ public static void main (String args[ ] ) 
{ int tH] = { 2, 5, 6, 8, 9} ; 
int t2[ ] = { 3, 6, 7, 9} ; 

HashSet <Integer> el = new HashSet <Integer>(), e2 = new HashSet<Integer> () ; 

// HashSet el = new HashSet (), e2 = new HashSet () ; <— avant JDK 5.0 
for (int v : tl) el. add (v) ; 

// for (int i=0 ; i< tl. length ; i++) el. add (new Integer (tl[ i] ) ) ; 
for (int v : t2) e2.add (v) ; 

// for (int i=0 ; i< t2. length ; e2.add (new Integer (t2[ i] ) ) ; 

System. out. println ("el = " + el) ; System. out .println ("el = " + e2) ; 

// reunion de el et e2 dans ul 

HashSet <Integer> ul = new HashSet <Integer> () ; 

// HashSet ul = new HashSet () ; <— avant JDK 5.0 
copie (ul, el) ; // copie el dans ul 
ul.addAll (e2) ; 

System. out .println ("ul = " + ul) ; 

// intersection de el et e2 dans il 

HashSet <Integer> il = new HashSet <Integer> () ; 

// HashSet il = new HashSet () ; <— avant JDK 5.0 

copie (il, el) ; 
il.retainAll (e2) ; 
System. out .println ("il = " + il) ; 

} 

public static <E> void copie (HashSet<E> but, HashSet<E> source) 

// public static void copie (HashSet but, HashSet source) < 
{ Iterator<E> iter = source . iterator ( ) ; 

// Iterator iter = source. iterator () ; < 

while (iter .hasNext () ) 
{ but . add ( iter . next ( ) ) ; 
} 

} 

} 

el = [ 9, 8, 6, 5, 2] 
el = [ 9, 7, 6, 3] 
ul = [ 9, 8, 7, 6, 5, 3, 2] 
il = [ 9, 6] 

Operations ensemblistes 

Exemple 2 

Voici un second exemple montrant Finteret des operations ensemblistes pour determiner les 
lettres et les voyelles presentes dans un texte. Notez qu'ici nous avons considere les lettres 



— avant JDK 5.0 

— avant JDK 5.0 
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comme des chaines (String) de longueur 1 ; nous aurions pu egalement utiliser la classe enve- 
loppe Character). On notera la presence de la lettre "espace". 

import java.util.* ; 
public class Ens2 

{ public static void main (String args[ ] ) 

{ String phrase = "je me figure ce zouave qui joue" ; 
String voy = "aeiouy" ; 

HashSet <String> lettres = new HashSet <String>() ; 

// HashSet lettres = new HashSet () ; < — avant JDK 5.0 
for (int i=0 ; Kphrase . length ( ) ; i++) 

lettres. add (phrase. substring (i, i+1) ) ; 
System. out. println ("lettres presentes : " + lettres) ; 

HashSet <String> voyelles = new HashSet<String> () ; 

// HashSet voyelles = new HashSet () ; < — avant JDK 5.0 
for (int i=Q ; i< voy. length () ; i++) 

voyelles. add (voy. substring (i, i+1)) ; 
lettres . removeAll (voyelles ) ; 

System. out. println ("lettres sans les voyelles : " + lettres) ; 

} 

} 

lettres presentes : [ c, a, , z, v, u, r, q, o, m, j, i, g, f, e] 
lettres sans les voyelles : [ c, , z, v, r, q, m, j, g, f] 

Determination des lettres presentes dans un texte 

4.5 Les ensembles HashSet 

Jusqu'ici, nous n'avons considere que des ensembles dont les elements etaient d'un type 
String ou enveloppe pour lesquels, comme nous l'avons dit en introduction, nous n'avions 
pas a nous preoccuper des details d' implementation. 

Des que Ton cherche a utiliser des elements d'un autre type objet, il est necessaire de connai- 
tre quelques consequences de la maniere dont les ensembles sont effectivement implemen- 
ted. Plus precisement, dans le cas des HashSet, vous devrez definir convenablement : 

• la methode equals : c'est toujours elle qui sert a definir F appartenance d'un element a 1' en- 
semble, 

• la methode hashCode dont nous allons voir comment elle est exploitee pour ordonnancer les 
elements d'un ensemble, ce qui va nous amener a parler de "table de hachage". 

4.5.1 Notion de table de hachage 

Une table de hachage est une organisation des elements d'une collection qui permet de 
retrouver facilement un element de valeur donnee 1 . Pour cela, on utilise une methode (hash- 
Code) dite "fonction de hachage" qui, a la valeur d'un element (existant ou recherche), asso- 
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cie un entier. Un meme entier peut correspondre a plusieurs valeurs differentes. En revanche, 
deux elements de meme valeur doivent toujours fournir le meme code de hachage. 

Pour organiser les elements de la collection, on va constituer un tableau de N listes chainees 
(nominees souvent seaux). Initialement, les seaux sont vides. A chaque ajout d'un element a 
la collection, on lui attribuera un emplacement dans un des seaux dont le rang ; (dans le 
tableau de seaux) est defini en fonction de son code de hachage code de la maniere suivante : 

i = code % N 

S'il existe deja des elements dans le seau, le nouvel element est ajoute a la fin de la liste chai- 
nee correspondante. 

On peut recapituler la situation par ce schema : 

I ^ I I seau de rang 0 : 1 element 

seau de rang 1 : 0 element 



i I ^ I I seau de rang i : 2 elements 



Comme on peut s'y attendre, le choix de la valeur (initiale) de N sera fait en fonction du nom- 
bre d' elements prevus pour la collection. On nomme "facteur de charge" le rapport entre le 
nombre d'elements de la collection et le nombre de seaux N. Plus ce facteur est grand, moins 
(statistiquement) on obtient de seaux contenant plusieurs elements ; plus il est grand, plus le 
tableau de references des seaux occupe de Fespace. Generalement, on choisit un facteur de 
l'ordre de 0.75. Bien entendu, la fonction de hachage joue egalement un role important dans 
la bonne repartition des codes des elements dans les differents seaux. 

Pour retrouver un element de la collection (ou pour savoir s'il est present), on determine son 
code de hachage code. La formule ; = code % N fournit un numero i de seau dans lequel 
1' element est susceptible de se trouver. II ne reste plus qu'a parcourir les differents elements 
du seau pour verifier si la valeur donnee s'y trouve (equals). Notez qu'on ne recourt a la 
methode equals que pour les seuls elements du seau de rang ; (nous verrons plus loin en quoi 
cette remarque est importante). 

Avec Java, les tables de hachage sont automatiquement agrandies des que leur facteur de 
charge devient trap grand (superieur a 0.75). On retrouve la un mecanisme similaire a celui 
de la gestion de la capacite d'un vecteur. Certains constructeurs d' ensembles permettent de 
choisir la capacite et/ou le facteur de charge (voyez 1' annexe G). 



1. N'oubliez pas que la valeur d'un element est formee de la valeur de ses differents champs (on pourrait aussi 
parler d'etat). 
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4.5.2 La methode hashCode 

Elle est done utilisee pour calculer le code de hachage d'un objet. Les classes String, File et 
les classes enveloppes definissent une methode hashCode utilisant la valeur effective des 
objets (e'est pourquoi nous avons pu constituer sans probleme des HashSet d' elements de ce 
type). En revanche, les autres classes ne (re)definisssent pas hashCode et Ton recourt a la 
methode hashCode heritee de la classe Object, laquelle se contente d'utiliser comme "valeur" 
la simple adresse des objets. Dans ces conditions, deux objets differents de meme valeur 
auront toujours des codes de hachage differents. 

Si Ton souhaite pouvoir definir une egalite des elements basee sur leur valeur effective, il va 
done falloir definir dans la classe correspondante une methode hashCode : 

int hashCode () 

Elle doit fournir le code de hachage correspondant a la valeur de 1' objet. 

Dans la definition de cette fonction, il ne faudra pas oublier que le code de hachage doit etre 
compatible avec equals. Deux objets egaux pour equals doivent absolument fournir le meme 
code, sinon ils risquent d'aller dans deux seaux differents ; dans ce cas, ils n'apparaitront 
plus comme egaux (puisque Ton ne recourt a equals qu'a l'interieur d'un meme seau). De 
meme, on ne peut pas se permettre de definir seulement equals sans (re)definir hashCode. 

4.5.3 Exemple 

Voici un exemple utilisant un ensemble d'objets de type Point. La classe Point redefinit con- 
venablement les methodes equals et hashCode. Nous avons choisi ici une determination sim- 
ple du code de hachage (somme des deux coordonnees). 



import java.util.* ; 
public class EnsPtl 

{ public static void main (String args[ ] ) 

{ Point pi = new Point (1, 3) , p2 = new Point (2, 2) ; 
Point p3 = new Point (4, 5), p4 = new Point (1, 8) ; 
Point p[] = {pi, p2, pi, p3, p4, p3} ; 
HashSet<Point> ens = new HashSet<Point> () ; 

// HashSet ens=new HashSet () ; < — avant JDK 5.0 
for (Point px : p) // for (int i=0 ; i<p. length ; i++) < — avant JDK 5.0 

{ System. out. print ("le point ") ; 

px.afficheO ; // p[ i] .afficheO ; < — avant JDK 5.0 

boolean ajoute = ens. add (px) ; 

// boolean ajoute = ens. add (p[ i] ) ; < — avant JDK 5.0 
if (ajoute) System. out. println (" a ete ajoute") ; 

else System. out. println ("est deja present") ; 
System. out. print ("ensemble = " ) ; affiche(ens) ; 

} 

} 

public static void affiche (HashSet<Point> ens) 

// public static void affiche (HashSet ens) < — avant JDK 5.0 
{ Iterator<Point> iter = ens . iterator ( ) ; 

// Iterator iter = ens . iterator ( ) ; < — avant JDK 5.0 
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while (iter .hasNext () ) 
{ Point p = iter . next ( ) 
p . af f iche ( ) ; 



// Point p = (Point) iter .next () 



< — avant JDK 5.0 



System . out . println ( ) 



class Point 

{ Point (int x, int y) { this.x = x ; this.y = y ; } 
public int hashCode () 
{ return x+y ; } 

public boolean equals (Object pp) 
{ Point p = (Point) pp ; 

return ((this.x == p.x) & (this.y == p.y)) ; 

} 

public void affiche () 

{ System. out. print ("[ " + x + " " + y + "] ") ; 

} 

private int x, y ; 



le point [13] a ete ajoute 

ensemble =[13] 

le point [2 2] a ete ajoute 

ensemble =[22] [13] 

le point [ 1 3] est deja present 

ensemble =[22] [13] 

le point [4 5] a ete ajoute 

ensemble =[45] [22] [13] 

le point [18] a ete ajoute 

ensemble =[18] [45] [22] [13] 

le point [ 4 5] est deja present 

ensemble =[18] [45] [22] [13] 



Le choix de la fonction de hachage a ete dicte ici par la simplicite. En pratique, on voit 
que plusieurs points peuvent avoir le meme code de hachage (il suffit que la somme de 
leurs coordonnees soit la meme). Dans la pratique, il faudrait choisir une formule qui 
eparpille bien les codes. Mais cela n'est possible que si Ton dispose d' informations statis- 
tiques sur les valeurs des coordonnees des points. 



Exemple de redefinition de hashCode 




Remarqi 



ue 
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4.6 Les ensembles TreeSet 

4.6.1 Generalites 

Nous venons de voir comment les ensembles HashSet organisaient leurs elements en table 
de hachage, en vue de les retrouver rapidement (efficacite en 0( 1 )). La classe TreeSet pro- 
pose une autre organisation utilisant un "arbre binaire", lequel permet d'ordonner totalement 
les elements. On y utilise, cette fois, la relation d'ordre usuelle induite par la methode compa- 
reTo des objets ou par un comparateur (qu'on peut fournir a la construction de Fensemble). 

Dans ces conditions, la recherche dans cet arbre d'un element de valeur donnee est generale- 
ment moins rapide que dans une table de hachage mais plus rapide qu'une recherche 
sequentielle. On peut montrer que son efficacite est en O(LogN). Par ailleurs, Futilisation 
d'un arbre binaire permet de disposer en permanence d'un ensemble totalement ordonne 
(trie). On notera d' ailleurs que la classe TreeSet dispose de deux methodes specifiques first et 
last fournissant respectivement le premier et le dernier element de 1' ensemble. 

Remarque 

On notera bien que, dans un ensemble TreeSet, la methode equals n'intervient ni dans 
l'organisation de l'ensemble, ni dans le test d'appartenance d'un element. L'egalite est 
definie uniquement a l'aide de la methode compareTo (ou d'un comparateur). Dans un 
ensemble HashSet, la methode equals intervenait (mais uniquement pour des elements de 
meme numero de seau). 

4.6.2 Exemple 

Nous pouvons essayer d'adapter l'exemple du paragraphe 4.5.3, de maniere a utiliser la 
classe TreeSet au lieu de la classe HashSet. La methode main reste la meme, a ceci pres qu'on 
y utilise le type TreeSet en lieu et place du type HashSet. 

Nous modifions la classe Point en supprimant les methodes hashCode et equals et en lui fai- 
sant implementer l'interface Comparable en redefinissant compareTo. Ici, nous avons choisi 
d'ordonner les points d'une maniere qu'on qualifie souvent de "lexicographique" : on com- 
pare d'abord les abscisses ; ce n'est qu'en cas d'egalite des abscisses qu'on compare les 
ordonnees. Notez bien que l'egalite n'a lieu que pour des points de memes coordonnees. 

Voici notre nouvelle classe Point : 

class Point implements Comparable // ne pas oublier implements .... 
{ Point (int x, int y) { this.x = x ; this.y = y ; } 
public int compareTo (Object pp) 

{ Point p = (Point) pp ; // egalite si coordonnees egales 
if (this.x < p.x) return -1 ; 
else if (this.x > p.x) return 1 ; 
else if (this.y < p.y) return -1 ; 
else if (this.y > p.y) return 1 ; 
else return 0 ; 

} 
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public void affiche () 

{ System. out. print ("[ " + x + " " + y + "] ") ; } 
private int x, y ; 

} 

Le programme complet ainsi modifie figure sur le site Web d'accompagnement sous le nom 
EnsPt2.java. Voici les resultats obtenus : 



le point 


[ 1 


3] 


a ete ajoute 


ensemble 


= [ 


1 


3] 


le point 


[ 2 


2] 


a ete ajoute 


ensemble 


= [ 


1 


3] [2 2] 


le point 


[ 1 


3] 


est deja present 


ensemble 


= [ 


1 


3] [2 2] 


le point 


[ 4 


5] 


a ete ajoute 


ensemble 


= [ 


1 


3] [2 2] [4 5] 


le point 


[ 1 


8] 


a ete ajoute 


ensemble 


= [ 


1 


3] [18] [2 2] [4 


le point 


[ 4 


5] 


est deja present 


ensemble 


= [ 


1 


3] [18] [2 2] [4 



\^^~ Remarque 

Depuis Java 6, les ensembles TreeSet implemented en outre F interface NavigableSet qui 
prevoit des methodes exploitant l'ordre total induit par l'organisation de l'ensemble (en 
un arbre binaire). Ces methodes permettent de retrouver et, eventuellement, de supprimer 
l'element le plus petit ou le plus grand au sens de cet ordre, ou encore de trouver l'ele- 
ment le plus proche (avant ou apres) d'une "valeur" donnee. II est possible de parcourir 
les elements dans l'ordre inverse de l'ordre "naturel". Enfin, certaines methodes permet- 
tent d'obtenir une "vue" (cette notion sera presentee ulterieurement) d'une partie de 
l'ensemble, formee des elements de valeur superieure ou inferieure a une valeur donnee. 
Ces differentes methodes sont recapitulees en annexe G. 

Notez que certaines d'entre elles peuvent fournir en resultat la valeur null qui risque de 
se confondre avec la reference a un element si Ton a accepte cette possibilite. Si tel est 
le cas, il reste cependant possible de lever l'ambiguite en testant simplement la valeur 
de contains(null). 

5 Les queues (JDK 5.0) 

5.1 Li interface Queue 

Le JDK 5.0 a introduit une nouvelle interface Queue (derivee elle aussi de Collection), desti- 
nee a la gestion des files d'attente (ou queues). II s'agit de structures dans lesquelles on peut : 

• introduire un nouvel element, si la queue n'est pas pleine, 

• prelever le premier element de la queue, 
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L' introduction d'un nouvel element dans la queue se fait a l'aide d'une nouvelle methode 
offer qui presente sur la methode add (de 1' interface Collection) l'avantage de ne pas declen- 
cher d'exception quand la queue est pleine ; dans ce cas, offer renvoie simplement la valeur 
false. 

Le prelevement du premier element de la queue peut se faire : 

• de facon destructive, a l'aide de la methode poll : 1' element ainsi preleve est supprime de la 
queue ; la methode renvoie null si la queue est vide, 

• de facon non destructive a l'aide de la methode peek. 

5.2 Les classes implementant I'interface Queue 

Deux classes implementent I'interface Queue : 

• La classe LinkedList, modifiee par le Java 5, pour y integrer les nouvelles methodes. On no- 
tera que, depuis Java 6, LinkedList implemente egalement I'interface Deque (presentee ci- 
apres) disposant de methodes d' action a la fois sur le debut et sur la fin de la liste. 

• La classe PriorityQueue, introduite par Java 5, permet de choisir une relation d'ordre ; dans 
ce cas, le type des elements doit implementer I'interface Comparable ou etre dote d'un com- 
parateur approprie. Les elements de la queue sont alors ordonnes par cette relation d'ordre 
et le prelevement d'un element porte alors sur le "premier" au sens de cette relation (on parle 
du "plus prioritaire", d'oii le nom de PriorityQueue). 

Toutes les methodes concernees sont decrites en annexe G. 

6 Les queues a double entree Deque (Java 6) 

6.1 L'interface Deque 

Java 6 a introduit une nouvelle interface Deque, derivee de Queue, destinee a gerer des files 
d'attente a double entree, c'est-a-dire dans lesquelles on peut realiser l'une des operations 
suivantes a l'une des extremites de la queue : 

• aj outer un element, 

• examiner un element, 

• supprimer un element. 

Pour chacune des ces 6 possibilites (3 actions, 2 extremites), il existe deux methodes : 

• l'une declenchant une exception quand l'operation echoue (pile pleine ou vide, selon le cas), 

• 1' autre renvoyant une valeur particuliere {null pour une methode de prelevement ou d'exa- 
men, false pour une methode d'ajout). 
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Voici la liste de ces methodes (First correspondant aux actions sur la tete, Last aux actions 
sur la queue et e designant un element) : 





Exception 


Valeur speciale 


Ajout 


addFirst (e) 


offerFirst () 


addLast (e) 


offerLast () 


Examen 


getFirst () 


peekFirst () 




getLast() 


peekLast () 


Suppression 


removeFirst () 


pollFirst () 




removeLast () 


pollLast () 



A noter que les methodes de l'interface Queue restent utilisables, sachant que celles d'ajout 
agissent sur la queue, tandis que celles d'examen ou de suppression agissent sur la tete. 

Deux classes implementent l'interface Deque : 

• la classe LinkedList, modifiee a nouveau par Java 6, de facon appropriee ; 

• la nouvelle classe ArrayDeque presentee ci-apres. 

6.2 La classe ArrrayDeque 

II s'agit d'une implementation d'une queue a double entree sous forme d'un tableau (ele- 
ments contigus en memoire) redimensionnable a volonte (comme Vest Array List). On notera 
bien que, malgre son nom, cette classe n'est pas destinee a concurrencer ArrayList, car elle ne 
dispose pas d'operateur d'acces direct a un element. II s'agit simplement d'une implementa- 
tion plus efficace que LinkedList pour une queue a double entree. 

Hormis les constructeurs, les methodes specifiques a cette implementation sont 
descendinglterator, removeFirstOccurrence et removeLastOccurren.ee . 



7 Les algorithmes 

La classe Collections fournit, sous forme de methodes statiques, des methodes utilitaires 
generales applicables aux collections, notamment : 

• recherche de maximum ou de minimum, 

• tri et melange aleatoire, 

• recherche binaire, 

• copie... 

Ces methodes disposent d' arguments d'un type interface Collection ou List. Dans le premier 
cas, 1' argument effectif pourra etre une collection quelconque. Dans le second cas, il devra 
s'agir obligatoirement d'une liste chainee (LinkedList) ou d'un vecteur dynamique (ArrayList 
ou Vector). Nous allons examiner ici les principales methodes de la classe Collections, 
sachant qu'elles sont toutes recapitulees en annexe G. 
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7.1 Recherche de maximum ou de minimum 

Ces algorithmes s'appliquent a des collections quelconques (implementant l'interface Col- 
lection), lis utilisent une relation d'ordre definie classiquement : 

• soit a partir de la methode compareTo des elements (il faut qu'ils implementent l'interface 
Comparable), 

• soit en fournissant un comparateur en argument de Falgorithme. 

Voici un exemple de recherche du maximum des objets de type Point d'une liste I. La classe 
Point implemente ici l'interface Comparable et definit compareTo en se basant uniquement 
sur les abscisses des points. L'appel : 

Collections . max ( 1 ) 

recherche le "plus grand element" de /, suivant cet ordre. 
Par ailleurs, on effectue un second appel de la forme : 

Collections .max (1, new Comparator () { } 

On y fournit en second argument un comparateur anonyme, c'est-a-dire un objet implemen- 
tant l'interface Comparator et definissant une methode compare (revoyez le paragraphe 
1.2.2). Cette fois, nous ordonnons les points en fonction de leur ordonnee. 

import java.util.* ; 
public class MaxMin 

{ public static void main (String args[ ] ) 

{ Point pi = new Point (1, 3) ; Point p2 = new Point (2, 1) ; 
Point p3 = new Point (5, 2) ; Point p4 = new Point (3, 2) ; 
LinkedList <Point> 1 = new LinkedList <Point> () ; 

// LinkedList 1 = new LinkedList () ; < — avant JDK 5.0 
l.add (pi) ; l.add (p2) ; l.add (p3) ; l.add (p4) ; 

/* max de 1 , suivant 1' ordre def ini par compareTo de Point * / 
Point pMaxl = Collections .max (1) ; 

//Point pMaxl = (Point) Collections .max (1) ; < — avant JDK 5.0 
System . out .print ( "Max suivant compareTo = " ) ; pMaxl . af f iche ( ) ; 
System. out. println () ; 

/* max de 1, suivant 1' ordre def ini par un comparateur anonyme */ 
Point pMax2 = (Point) Collections .max (1, new Comparator () 

{ public int compare (Object ol, Object o2) 

{ Point pi = (Point) ol ; Point p2 = (Point) o2 ; 
if (pl.y < p2.y) return -1 ; 

else if (pl.y == p2.y) return 0 ; 
else return 1 ; 

} 

} ) ; 

System. out. print ("Max suivant comparator = " ) ; pMax2 . af f iche ( ) ; 

} 

) 
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class Point implements Comparable 

{ Point (int x, int y) { this.x = x ; this.y = y ; } 

public void affiche () 

{ System. out. print ("[ " + x + " " + y + "] ") ; 

} 

public int compareTo (Object pp) 
{ Point p = (Point) pp ; 

if (this.x < p.x) return -1 ; 

else if (this.x == p.x) return 0 ; 
else return 1 ; 

} 

public int x, y ; // public ici, pour simplifier les choses 



Max suivant compareTo = [5 2] 
Max suivant comparator = [13] 

Recherche de maximum d'une liste de points 



Remarques 

1 Ici, notre collection, comme toute liste, dispose d'un ordre naturel. Cela n'empeche nulle- 
ment d'y definir un ou plusieurs autres ordres, bases sur la valeur des elements. 

2 La methode compareTo ou le comparateur utilises ici sont tres simplistes. Notre but 
etait essentiellement de montrer que plusieurs ordres differents peuvent etre appliques 
(a des instants differents) a une meme collection. 

7.2 Tris et melanges 

La classe Collections dispose de methodes sort qui realisent des algorithmes de "tri" des ele- 
ments d'une collection qui doit, cette fois, implementer F interface List. Ses elements sont 
reorganises de facon a respecter l'ordre induit soit par compareTo, soit par un comparateur. 
L'efficacite de Foperation est en 0(N Log N). Le tri est "stable", ce qui signifie que deux ele- 
ments de meme valeur (au sens de l'ordre induit) conservent apres le tri leur ordre initial. 

La classe Collections dispose egalement de methodes shuffle effectuant un melange aleatoire 
des elements d'une collection (implementant, la encore, l'interface List). Cette fois, leur effi- 
cacite depend du type de la collection ; il est : 

• en O(N) pour un vecteur dynamique, 

• en 0(N * N) pour une liste chainee, 

• en 0(N * a(N)) pour une collection quelconque (que vous aurez pu definir), a(N) designant 
l'efficacite de Faeces a un element quelconque de la collection. 

Voici un exemple dans lequel nous trions un vecteur d' elements de type Integer. Rappelons 
que la methode compareTo de ce type induit un ordre naturel. Nous effectuons ensuite un 
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melange aleatoire puis nous trions a nouveau le tableau en fournissant a 1'algorithme sort un 
comparateur predefini nomme reverseOrder ; ce dernier inverse simplement l'ordre induit 
par compareTo. 

import java.util.* ; 
public class Tril 

{ public static void main (String args[ ] ) 
{ int nb[ ] = { 4, 9, 2, 3, 8, 1, 3, 5} ; 

ArrayList<Integer> t = new ArrayList <Integer>() ; 

// ArrayList t = new ArrayList () ; < — avant JDK 5.0 

for (Integer v : nb) t.add (v) ; 

// for (int i=0 ; i<nb. length ; i++) t.add (new Integer (nfc[ i] )) ; <- 
System. out. println ("t initial = " + t) ; 

Collections . sort (t) ; 

System. out. println ("t trie = " + t) ; 

Collections . shuffle (t) ; 

System. out. println ("t melange = " + t) ; 

Collections . sort (t, Collections . reverseOrder () ) ; 
System. out. println ("t trie inverse = " + t) ; 

} 

} 

t initial = [ 4, 9, 2, 3, 8, 1, 3, 5] 

t trie = [ 1, 2, 3, 3, 4, 5, 8, 9] 

t melange = [ 2, 9, 8, 5, 1, 4, 3, 3] 

t trie inverse = [ 9, 8, 5, 4, 3, 3, 2, 1] 

Tri et melange aleatoire d'une liste d 'elements de type Integer 

7.3 Autres algorithmes 

La plupart des algorithmes de la classe Collections sont recapitules en annexe G. Vous y note- 
rez la presence d'un algorithme de recherche binaire binarySearch. Comme les algorithmes 
precedents, il se base sur l'ordre induit par compareTo ou un comparateur. II suppose, en 
revanche, que la collection est deja convenablement ordonnee suivant cet ordre. II possede 
une efficacite en 0(Log N) pour les vecteurs dynamiques, en 0(N Log N) pour les listes chai- 
nees et en 0(a(N) Log N) d'une maniere generate. 

En outre, il possede la particularite de definir l'endroit ou viendrait s'inserer (toujours suivant 
l'ordre en question) un element de valeur donnee (non present dans la collection). Plus 
precisement : 

binarySearch (collection, valeur) 

fournit un entier i representant : 

• la position de valeur dans la collection, si elle y figure, 

• une valeur negative telle que valeur puisse s'inserer dans la collection a la position de rang 
-i-1, si elle n'y figure pas. 
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8 Les tables associatives 

8.1 Generalites 

Une table associative permet de conserver une information associant deux parties nominees 
cle et valeur. Elle est principalement destinee a retrouver la valeur associee a une cle donnee. 
Les exemples les plus caracteristiques de telles tables sont : 

• le dictionnaire : a un mot (cle), on associe une valeur qui est sa definition, 

• l'annuaire usuel : a un nom (cle), on associe une valeur comportant le numero de telephone 
et, eventuellement, une adresse, 

• l'annuaire inverse : a un numero de telephone (qui devient la cle), on associe une valeur 
comportant le nom et, eventuellement, une adresse. 

On notera que les ensembles deja etudies sont des cas particuliers de telles tables, dans les- 
quelles la valeur serait vide. 

Depuis le JDK 5.0, les tables associatives sont generiques, au meme titre que les collections, 
mais elles sont definies par deux parametes de type (celui des cles, note generalement K, 
celui des valeurs, note generalement V) au lieu d'un. 

8.2 Implementation 

Comme pour les ensembles, l'interet des tables associatives est de pouvoir y retrouver rapi- 
dement une cle donnee pour en obtenir 1' information associee. On va done tout nature llement 
retrouver les deux types d'organisation rencontres pour les ensembles : 

• table de hachage : classe HashMap, 

• arbre binaire : classe TreeMap. 

Dans les deux cas, seule la cle sera utilisee pour ordonnancer les informations. Dans le pre- 
mier cas, on se servira du code de hachage des objets formant les cles ; dans le second cas, on 
se servira de la relation d'ordre induite par compareTo ou par un comparateur fixe a la cons- 
truction. 

L'acces a un element d'un HashMap sera en 0(1) tandis que celle a un element d'un Tree- 
Map sera en 0(Log N)). En contrepartie de leur acces moins rapide, les TreeMap seront 
(comme les TreeSet) ordonnes en permanence suivant leurs cles. 

8.3 Presentation generale des classes HashMap et TreeMap 

Comme nous l'avons signale, les classes HashMap et TreeMap n'implementent plus l'inter- 
face Collection mais une autre interface nommee Map. Ceci provient essentiellement du fait 
que leurs elements ne sont plus a proprement parler des objets mais des "paires" d'objets 
e'est-a-dire une association entre deux objets. 
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Ajout d'information 

La plupart des constructeurs creent une table vide. Pour ajouter une cle a une table, on utilise 
la methode put a laquelle on fournit la cle et la valeur associee ; par exemple, si K designe le 
type des cles et V celui des valeurs : 

/* creation d' une table vide * / 
HashMap <K, V> m = new HashMap <K, V> () ; 

// HashMap m = new HashMap () ; < — avant JDK 5.0 

/* ajoute a m, un element associant la cle "m" (String) a la valeur 3 (Integer) */ 
m.put ("m", 3) ; // m.put ("m", new Integer (3)) ; < — avant JDK 5.0 

Si la cle fournie a put existe deja, la valeur associee remplacera Fancienne (une cle donnee ne 
pouvant figurer qu'une seule fois dans une table). D'ailleurs, put fournit en retour soit 
Fancienne valeur si la cle existait deja, soit null. 

Notez que, comme pour les autres collections, les cles et les valeurs doivent etre des objets. II 
n'est theoriquement pas necessaire que toutes les cles soient de meme type, pas plus que les 
elements. En pratique, ce sera presque toujours le cas pour des questions evidentes de facilite 
d' exploitation de la table. 

Recherche d'information 

On obtient la valeur associee a une cle donnee a Faide de la methode get, laquelle fournit null 
si la cle cherchee n'est pas presente (K represente le type de la cle) : 

K o = get ("x") ; // fournit la valeur associee a la cle "x" // K = Object avant JDK 
5.0 

if (o == null) System. out. println ("Aucune valeur associee a la cle x") ; 

L'efficacite de cette recherche est en 0(1) pour HashMap et en 0(Log N) pour TreeMap. 

La methode containsKey permet de savoir si une cle donnee est presente (au sens defini au 
paragraphe 1.3), avec la meme efficacite. 

Suppression d'information 

On peut supprimer un element d'une table en utilisant la methode remove, laquelle fournit en 
retour Fancienne valeur associee si la cle existe ou la valeur null dans le cas contraire : 

K cle = "x" ; // faire K = Object avant JDK 5.0 

K val = remove (cle) ; // supprime 1' element (cle + valeur) de cle "x" 
if (val != null) 

System. out. println ("On a supprime 1' element de cle " + cle 
+ " et de valeur" + val) ; 
else System. out. println ("la cle " + cle + " n' existe pas") ; 

8.4 Parcours d'une table ; notion de vue 

En theorie, les types HashMap et TreeMap ne disposent pas d'iterateurs. Mais on peut facile - 
ment, a Faide d'une methode nommee entrySet, "voir" une table comme un ensemble de 
"paires", une paire n'etant rien d'autre qu'un element de type Map. Entry reunissant deux 
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objets (de types a priori quelconques). Les methodes getKey et getValue du type Map.Entry 
permettent d'extraire respectivement la cle et la valeur d'une paire. Nous vous proposons un 
canevas de parcours d'une table utilisant ces possibilites ; ici, nous avons prefere separer la 
version generique (depuis JDK 5.0) de la version non generique (avant JDK 5.0) 

HashMap <K, V> m ; 

Set <Map . entry<K, V> > entrees = m.entrySet () ; // entrees est un ensemble de "paires" 
Iterator <Map . entry<K, V> > iter = entrees . iterator ( ) ; / / iterateur sur les paires 
while (iter .hasNext () ) // boucle sur les paires 

{ Map.Entry <K, V> entree = (Map . Entry ) iter . next ( ) ; // paire courante 
K cle = entree . getKey () ; // cle de la paire courante 

V valeur = entree . getValue ( ) ; // valeur de la paire courante 

} 

Canevas de parcours d'une table (depuis JDK 5.0) 

HashMap m ; 

Set entrees = m.entrySet () ; // entrees est un ensemble de "paires" 

Iterator iter = entrees . iterator () ; // iterateur sur les paires 
while (iter .hasNext () ) // boucle sur les paires 

{ Map.Entry entree = (Map . Entry ) iter . next ( ) ; // paire courante 

Object cle = entree . getKey () ; // cle de la paire courante 

Object valeur = entree . getValue ( ) ; // valeur de la paire courante 

} 

Canevas de parcours d'une table (avant JDK 5.0) 

Notez que l'ensemble fourni par entrySet n'est pas une copie des informations figurant dans 
la table m. II s'agit de ce que Ton nomme une "vue". Si Ton opere des modifications dans m, 
elles seront directement perceptibles sur la vue associee. De plus, si Ton applique la methode 
remove a un element courant (paire) de la vue, on supprime du meme coup 1' element de la 
table. En revanche, il n'est pas permis d'ajouter directement des elements dans la vue elle- 
meme. 

8.5 Autres vues associees a une table 

En dehors de la vue precedente, on peut egalement obtenir : 
• l'ensemble des cles a l'aide de la methode key Set : 

HashMap m ; 

Set cles = m. keyset () ; 
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On peut parcourir classiquement cet ensemble a Faide d'un iterateur. La suppression d'une 
cle (cle courante ou cle de valeur donnee) entraine la suppression de F element correspon- 
dant de la table m. 

• la "collection" des valeurs a l'aide de la methode values : 

Collection valeurs = m. values () ; 

La encore, on pourra parcourir cette collection a Faide d'un iterateur ; la suppression d'un 
element de cette collection (element courant ou element de valeur donnee) entraine la sup- 
pression de F element correspondant de la table m. 

On notera que Fon obtient une collection et non un ensemble car il est tout a fait possible 
que certaines valeurs apparaissent plusieurs fois. 

La encore, il ne sera pas permis d'ajouter directement des elements dans la vue des cles ou 
dans la vue des valeurs (de toute facon, cela n'aurait guere de sens puisque F information 
serait incomplete). 

8.6 Exemple 

Voici un programme qui constitue une table (HashMap) associant des cles de type String et 
des valeurs, elles aussi de type String. II illustre la plupart des fonctionnalites decrites prece- 
demment et, en particulier, les trois vues qu'on est susceptible d'associer a une table. On 
notera qu'ici il n'est pas utile de se preoccuper des methodes hashCode et equals, ce qui 
serait necessaire si Fon travaillait avec des cles ou des valeurs d'un type quelconque. 

import java.util.* ; 
public class Mapl 

{ public static void main (String args[ ] ) 

{ HashMap <String, String> m = new HashMap <String, String> () ; 

// HashMap m = new HashMap () ; < — avant JDK 5.0 
m.put ("c", "10") ; m.put ("f", "20") ; m.put ("k", "30") ; 
m.put ("x", "40") ; m.put ("p", "50") ; m.put ("g", "60") ; 
System. out. println ("map initial : " + m) ; 

// retrouver la valeur associee a la cle "f" 

String ch = m.get("f") ; // String ch = (String) m. get ("f") ; < — avant JDK 5.0 

System. out. println ("valeur associee a f : " + ch) ; 

// ensemble des valeurs (attention, ici Collection, pas Set) 
Collection; String> valeurs = m. values () ; 

// Collection valeurs = m. values () ; <- avant JDK 5.0 
System . out . println ("liste des valeurs initiates : " + valeurs) ; 

valeurs . remove ("30") ; // on supprime la valeur "30" par la vue associee 
System . out . println ("liste des valeurs apres sup : " + valeurs) ; 
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II ensemble des cles 

Set<String> cles = m.keySet () ; // Set cles = m.keySetO ; <— avant JDK 5.0 

System. out .println ("liste des cles initiales : " + cles) ; 

cles. remove ("p") ; //on supprime la cle "p" par la vue associee 
System. out .println ("liste des cles apres sup : " + cles) ; 



// modification de la valeur associee a la cle x 
String old = m.put("x", "25") ; 

// String old = (String) m. put ("x", "25") ; <- avant JDK 5.0 

if (old != null) 

System. out. println ("valeur associee a x avant modif : " + old) ; 
System. out. println ("map apres modif de x : " + m) ; 

System. out .println ("liste des valeurs apres modif de x : " + valeurs) ; 



// On parcourt les entrees (Map. Entry) du map jusgu' a trouver la valeur 20 
// et on supprime 1' element correspondant (suppose exister) 
Set<Map.Entry<String, String> > entrees = m.entrySet () ; 
Iterator<Map.Entry<String, String> > iter = entrees . iterator ( ) ; 

// Set entrees = m.entrySet () ; < — avant JDK 5.0 
// Iterator iter = entrees . iterator ( ) ; <- 



while (iter .hasNext () ) 

{ Map.Entry<String, String> entree = iter. next () ; 
String valeur = entree . getValue ( ) ; 

// Map. Entry entree = (Map . Entry ) iter . next ( ) ; < — avant JDK 5.0 
// String valeur = (String) entree. getValue () ; <- 
if (valeur . equals ("20")) 

{ System. out .println ("valeur 20 " + "trouvee en cle " 
+ entree . getKey ( ) ) ; 
iter . remove ( ) ; // suppression sur la vue associee 
break ; 

} 

} 

System. out .println ("map apres sup element suivant 20 : " + m) ; 



// on supprime 1' element de cle "f " 
m. remove ("f") ; 

System. out .println ("map apres suppression f : " + m) ; 

System. out .println ("liste des cles apres suppression f : " + cles) ; 
System. out. println ("liste des valeurs apres supp de f : " + valeurs) 



map initial : { c=10, x=40, p=50, k=30, g=60, f=20} 

valeur associee a f : 20 

liste des valeurs initiales : [ 10, 40, 50, 30, 60, 20] 

liste des valeurs apres sup : [ 10, 40, 50, 60, 20] 

liste des cles initiales : [ c, x, p, g, f] 

liste des cles apres sup : [ c, x, g, f] 
valeur associee a x avant modif : 40 

map apres modif de x : { c=10, x=25, g=60, f=20} 
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liste des valeurs apres modif de x : [ 10, 25, 60, 20] 
valeur 20 trouvee en cle f 

map apres sup element suivant 20 : { c=10, x=25, g=60} 

map apres suppression f : { c=10, x=25, g=60} 

liste des cles apres suppression f : [ c, x, g] 

liste des valeurs apres supp de f : [ 10, 25, 60] 



Utilisation d'une table de type HashMap 

Nous aurions pu utiliser sans problemes une table de type TreeMap. Le programme modifie 
dans ce sens figure sur le site Web d'accompagnement sous le nom Map2.java. A titre indica- 
tif, voici les resultats qu'il fournit (seul l'ordre des cles est modifie) : 

p=50, x=40} 



map initial : 


{ c=10, f= 


=20, 


g=60, k= 


=30, 


valeur associee a f : 


20 








liste des valeurs initiates : 


[ 10, 20, 


60, 


30, 50, 


40] 


liste des valeurs apres sup : 


[ 10, 20, 


60, 


50, 40] 




liste des cles initiales : 


[ c, f, g, 


P, 


x] 




liste des cles apres sup : 


t c, f, g, 


x] 






valeur associee a x avant modif : 


40 








map apres modif de x : 


{ o=10, f= 


=20, 


g=60, x= 


=25} 


liste des valeurs apres modif de x 


: [ 10, 20, 


60, 


25] 




valeur 20 trouvee en cle f 










map apres sup element suivant 20 : 


{ o=10, g= 


=60, 


x=25} 




map apres suppression f : 


{ £3=10, g= 


=60, 


x=25} 




liste des cles apres suppression f 


: [ c, g, x] 








liste des valeurs apres supp de f 


: [ 10, 60, 


25] 







> 



Remarque 

Depuis Java 6, les tables de type TreeMap implementent egalement l'interface Navigable- 
Map qui prevoit des methodes exploitant l'ordre total induit sur les cles, par l'organisa- 
tion en un arbre binaire. Ces methodes permettent de retrouver et, eventuellement, de 
supprimer les elements correspondant a la plus petite ou a la plus grande cle, ou encore de 
trouver 1' element ayant la cle la plus proche (avant ou apres) d'une "valeur" donnee. II est 
possible de parcourir les elements dans l'ordre inverse de l'ordre naturel des cles. Enfin, 
on peut obtenir une vue d'une partie du map, en se fondant sur la valeur d'une cle qui sert 
en quelque sorte de "delimiteur". Toutes ces methodes sont recapitulees en annexe G. 



9 Vues synchronisees ou non modifiables 

Nous venons de voir comment on pouvait obtenir une vue associee a une table. La vue cor- 
respondante est alors une "autre facon de voir" la collection. Elle peut interdire certaines 
operations : par exemple, dans la vue des cles, on peut supprimer une cle, mais on ne peut pas 
en ajouter. 
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Cette notion de vue se generalise quelque peu puisque Java dispose en fait de methodes (dans 
la classe Collections) permettant d'associer a n'importe quelle collection : 

• soit une vue dite synchronisee, 

• soit une vue non modifiable. 

Dans une vue synchronisee, les methodes modifiant la collection ont le qualificatif synchroni- 
zed de sorte qu'elles ne peuvent etre appelees simultanement par deux threads differents. 
Rappelons que les collections de Java 2 sont "non synchronisers " (exception faite de la classe 
Vector). 

Dans une vue non modifiable, les methodes modifiant la collection declenchent une excep- 
tion. 

Vous trouverez la liste de ces methodes en annexe G. 



Les methodes synchronizedCollection et unmodifiableCollection (et uniquement celles- 
la) fournissent une vue dans laquelle la methode equals n'utilise pas la methode equals 
des elements de la collection d'origine. II en va de meme pour une eventuelle methode 
hashCode. 





Remarque 
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Programmation Java cote 
serveur : servlets et JSP 



Jusqu'ici, nous avons vu comment developper une application autonome ou une applet, en 
nous appuyant sur les fonctionnalites standard de Java, telles qu'elles sont definies dans F edi- 
tion J2SE. L' edition elargie J2EE 1 comporte des specifications supplementaires concernant 
notamment le developpement de ce que Ton nomme des servlets (terme forme de la reunion 
de serv, debut du mot serveur et de let, par analogie avec app/ef)- H s'agit d' applications que 
Ton peut lancer sur une machine serveur depuis un poste client par F intermediate du web ou 
d'un intranet. A la difference de l'applet dont le code (residant sur le serveur) s'executait 
chez client, la servlet (dont le code reside toujours sur le serveur) s' execute sur le serveur. 

Dans ce chapitre, nous allons voir comment ecrire une servlet sur un serveur et comment la 
lancer depuis le poste client. Nous apprendrons comment le client peut communiquer des 
informations a une servlet, grace a la notion de parametre, ce qui nous amenera a parler des 
formulaires HTML. 

Puis nous aborderons F etude des JSP (JavaServer Pages), pages HTML dans lesquelles on 
peut introduire des sequences d' instructions Java. Nous verrons que, comme les servlets, les 
JSP peuvent recevoir des parametres. En outre, elles disposeront, entre autres, de "balises" 
specifiques leur permettant de manipuler des javaBeans (eventuellement sans code Java) ou 
encore de mettre facilement en ceuvre ce que Ton nomme le "suivi de session". 



1. Ce chapitre repose sur JEE5, qui integre la version 2.5 de Java Servlet et la version 2.1 de JSP. Les exemples ont 
ete testes a l'aide de Tomcat 6.0. 
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Premiere servlet 



Nous avons deja vu ce qu'etait une applet : application ecrite en Java dont le code executable 
(bytes codes) est automatiquement transmis par un serveur a un client a partir d'une simple 
demande d'affichage d'une page HTML. Le programme correspondant, bien que situe chez 
le serveur, s'execute chez le client en utilisant les ressources de ce dernier. 

La servlet consiste egalement en un programme Java situe sur le serveur mais, cette fois, il 
s'execute sur le serveur lui-meme et utilise done ses ressources, qu'il s'agisse de puissance 
de calcul ou d'acces a des bases de donnees. 

Comme pour une applet, le lancement d'une servlet se fait par la demande d'affichage d'une 
page HTML, en introduisant une URL dans un navigateur (ou en cliquant sur un lien). Nous 
verrons cependant plus loin qu'il existe des mecanismes supplementaires permettant au client 
de fournir des informations a la servlet. Pour F instant, nous commencerons par une servlet 
tres simple ne necessitant aucune transmission d' informations ; elle se contentera d'afficher 
dans une page le texte "bonjour". 



Une servlet va se presenter comme une classe derivee de la classe HttpServlet fournie dans le 
package javax. servlet 1 . La methode doGet, heritee de la classe HttpServlet est appelee lors- 
que le client lance la servlet correspondante. Elle dispose de deux arguments : 

• le premier, de type HttpRequest, permet de recuperer les informations fournies lors de 
l'appel ; pour l'instant, nous n'aurons pas a nous en preoccuper ; 

• le second, de type HttpServletResponse, cree automatiquement par l'environnement du ser- 
veur, permet d' identifier le client. 

Nous devons done redefinir cette methode doGet. Voici un premier canevas de notre classe 
servlet que nous nommerons Bonjour : 

import java.io.* ; 
import javax. servlet.* ; 
import javax. servlet. http.* ; 

public class Bonjour extends HttpServlet 

{ public void doGet (HttpServletRequest req, HttpServletResponse rep) 



1.1 



Ecriture de la servlet 



1.1.1 La classe HttpServlet et la methode doGet 



throws IOException, ServletException 
{ // instructions affichant bonjour dans la page 



1. Attention, ce package fait partie des specifications JEE et n'est pas contenu dans JSE. Suivant les cas, il se 
peut que vous ayez besoin de charger ou de telecharger des fichiers complementaires. 
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Notez que la methode doGet est susceptible de lever deux sortes d' exceptions : 

• IOException, definie dans le package java.io, 

• ServletException, definie dans le package javax.servlet. 

Par ailleurs, les classes HttpServlet, HttpServletRequest et HttpServletResponse sont definies 
dans le pakcage javax.servlet.http. 

D'ou les instructions import correspondantes. 

1.1.2 Construction de la reponse au client 

Le deuxieme parametre de doGet identifie le client. La methode getWriter de la classe 
HttpResponse fournit un flux de type PrintWriter qui sera automatiquement connecte au 
client correspondant (plus precisement a son navigateur). II suffit done d'afficher classique- 
ment les informations voulues, en recourant aux methodes de la classe PrintWriter, par 
exemple print ou println. 

Auparavant, cependant, il faudra prevenir le navigateur du client du type d' information qu'on 
va lui transmettre, meme si, comme e'est generalement le cas, il s'agit d'une page HTML. 
Pour ce faire, on applique la methode setContentType a l'objet reponse, en lui fournissant une 
chaine precisant le type (text) et le sous-type {html) : 

rep . setContentType ("text/html") ; 

Voici une premiere ebauche de notre methode doGet : 

public void doGet (HttpServletRequest req, HttpServletResponse rep) 
throws IOException, ServletException 
{ rep . setContentType ("text/html") ; 
PrintWriter paqe = rep . qetWriter ( ) ; 

// instructions du type page. print ( ) ou page. println ( ) 

// pour afficher les balises HTML dans la page a transmettre au client 

} 

Voici finalement le texte de notre servlet complete qui se contente d'afficher le message 
bonjour dans une page HTML ayant pour titre "Servlet Bonjour". 

import java.io.* ; 
import javax.servlet.* ; 
import javax.servlet.http.* ; 

public class Bonjour extends HttpServlet 

{ public void doGet (HttpServletRequest req, HttpServletResponse rep) 
throws IOException, ServletException 
{ rep . setContentType ("text/html") ; 
PrintWriter page = rep . getWriter ( ) ; 
page. println ("<html>") ; 
page. println ("<head>") ; 

page. println ("<title> Servlet Bonjour </title>") ; 
page. println ("</head>") ; 
page. println ("<body>") ; 
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page.println ("<font size=+2>") 
page.println ("EONJOUR") ; 
page.println ("</body>") ; 



Premiere servlet 



> 



Remarque 



Un navigateur affiche des informations de differents types : pages HTML, pages 
XML, images... Dans le cas d'un lien hypertexte, ce type est connu par l'extension du 
fichier correspondant (par exemple html, xml, gif, pdf...). Ce n'est pas le cas de la ser- 
vlet. C'est pourquoi a l'information recue par le navigateur se trouve associe ce que 
Ton nomme son type MIME (Multipurpose Internet Mail Extension) qui en precise la 
nature. On trouve par exemple les types text/html, text/xml, image/jpeg, image/gif, 
image/pjpeg, image. pgn. Souvent, comme ici, une servlet cree une information de 
type HTML. Mais on pourrait tres bien employer une servlet pour transmettre une 
image. 



Le client accede a la servlet comme il le fait pour une page web, en introduisant dans son 
navigateur une URL de la forme : 

http: / /localisationServeur/localisationServlet/nomServlet 

Pour pouvoir repondre a une telle requetre, la machine serveur doit disposer d'un logiciel 
particulier dit "serveur de servlets". Comme previsible, les informations localisationSer- 
veur et localisationServlet dependent des "coordonnees" de la machine serveur, de la 
maniere dont est configure le serveur de servlets et de 1' emplacement effectif de la servlet 
sur le serveur. 

Quoi qu'il en soit, suite a cette requete, le serveur de servlets fera appel a la machine virtuelle 
Java pour construire un objet du type voulu et initialiser convenablement son fonctionne- 
ment. Par exemple, dans le cas de notre servlet Bonjour, il y aura appel de la methode doGet 
de 1' objet ainsi construit. Notez bien que la classe de la servlet aura du etre prealablement 
compilee sur le serveur. 



En general, toute application web installee sur un serveur respecte l'organisation suivante : 



1.2 



Execution de la servlet depuis le client 



1.3 



Installation de la servlet sur le serveur 
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application dossier de 1' application 

I 

web dossier contenant les fichiers .html et . jsp 

I 

WEB_INF dossier contenant le fichier de configuration web.xml 

I 

classes fichiers .class des servlets 

Le fichier web.xml est nomme "fichier de deploiement". II contient, en particulier, des infor- 
mations etablissant une ou plusieurs correspondances entre un repertoire cite par le client et 
le veritable repertoire concerne sur le serveur. Si, par exemple, on a etabli une correspon- 
dance entre : 

servlet 

et 

WEB_INF/classes 
toute information de la forme : 

Chemin/servlet/nomServlet 

sera transformee en : 

Chemin/WEB_INF/classes/nomServlet 

1 .4 Test du fonctionnement d'une servlet 

II est generalement possible d' installer un logiciel serveur de servlets sur la meme machine 
que le client, ce qui facilite grandement la mise au point d'une servlet. Dans ce cas, l'infor- 
mation localisationServeur sera : 

localhost:8080 

Comme on le devine, localhost est l'identificateur de votre machine et 8080 est un "numero 
de port". Celui-ci n'a rien a voir avec les "ports materiels" d'un ordinateur. II ne s'agit que 
d'un numero (entier entre 1 et 65535) qui permet de distinguer differentes sortes de services 
sur une meme machine serveur. Generalement le port 80 est utilise pour un serveur web usuel 
et 8080 pour un serveur de servlets (ou de JSP). 
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Finalement, voici comment nous pouvons executer la servlet precedente en utilisant comme 
client la machine oil elle est installee : 



'3 Servlet Bonjour Microsoft Internet Explorer 
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Execution de la servlet Bonjour 



2 Transmission de parametres a une servlet 

Bien entendu, notre servlet Bonjour nous a permis de vous presenter le mecanisme des 
servlets. Elle ne presente aucun interet en soi ; une simple page HTML pourrait effectuer la 
meme operation. Fort heureusement, comme nous Favons dit en introduction, une servlet 
peut recevoir des informations du client et, par consequent, adopter un comportement 
dependant de ces informations ; c'est ce qui amene a parler de "pages dynamiques" pour 
indiquer que le contenu des pages affichees n'est plus statique come celui d'une simple page 
HTML, mais qu'il peut s' adapter a des requetes formulees par le client. 

Pour transmettre ces informations (nominees alors parametres) du client au serveur, le con- 
cepteur de la servlet peut choisir entre deux demarches : 

• demander au client d'incorporer ces parametres directement dans l'URL fournie au 
navigateur ; dans ce cas, leurs valeurs seront recuperees par la methode doGet deja rencon- 
tree, 

• recuperer ces informations aupres du client par le biais d'un "formulaire HTML" et lancer 
la servlet depuis ce formulaire. Dans ce cas, le concepteur de la servlet (et du formulaire) 
peut choisir entre deux methodes de transmission de ces informations ; 

- la methode "GET" : bien qu'elle soit automatisee a partir du formulaire, la transmission 
des parametres reste analogue a celle de la premiere demarche : l'appel de la servlet 
depuis le formulaire fabrique automatiquement l'URL voulue avec les parametres qui 
seront visibles dans le navigateur ; 

- la methode "POST" : cette fois, la transmission des parametres ne sera plus visible dans 
le navigateur. En revanche, la servlet devra faire appel a une methode differente, a sa- 
voir doPost. 
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On voit done que Futilisation des formulaires est necessaire des lors que Ton veut que les 
parametres soit transmis par la methode POST alors qu'elle ne Test pas avec la methode 
GET. Cependant, pour la progressivite de notre expose, nous commencerons par vous presen- 
ter une servlet recueillant des parametres par GET. 

Remarque 

Les deux demarches de transmission d' informations que nous venons d'evoquer (GET et 
POST) font partie du protocole de communication HTTP qu'utilisent les servlets etudiees 
ici 1 (derivees de la classe HttpServlef) et ne sont done pas specifiques aux servlets. 
Notamment, nous les retrouverons avec les JSP etudies plus loin. 

2.1 Transmission de parametres par GET 

Nous allons creer une servlet nommee BonjourVous qui generalise la servlet precedente, en 
recuperant un seul parametre, a savoir un prenom fourni par Futilisateur et qui l'affiche a la 
suite du texte bonjour dans une page HTML. 

2.1 .1 Appel de la servlet 

Pour faciliter la comprehension de l'ecriture de la servlet, il est preferable de voir comment le 
client devra l'appeler. Tout d'abord, il devra savoir, non seulement qu'elle attend la valeur 
d'un parametre (ici, une chaine de caracteres) mais aussi comment le concepteur de servlet a 
choisi de nommer ce parametre. Supposons qu'ici, il s'agisse de prenom. Dans ces condi- 
tions, 1' appel de notre servlet BonjourVous se presentera ainsi : 

http: //localisationServeur/localisationServlet/nomServlet?prenom=thibault 

On note, a la suite du nom de la servlet, F indication : 

? prenom=thibault 

qui precise que Ton donne au parametre nomme prenom la valeur thibault 

\^^~ Remarque 

D'une maniere generale, on peut placer plusieurs parametres dans l'appel de la servlet. Ceux- 
ci sont simplements separes les uns des autres par des caracteres &. Par ailleurs, tout espace 
figurant dans la valeur d'un parametre doit etre remplace par le caractere + et tout caractere 
non alphanumerique, excepte le caractere "souligne" (_) doit etre code sous la forme %xx ou 
xx designe son code hexadecimal. Par exemple, pour transmettre la valeur dupont au parame- 
tre nom et la valeur gerard au parametre prenom, on codera a la suite du nom de la servlet : 

? nom=dupont&prenom=g%E6rard 



1 . En toute rigueur, il est possible, mais cette methode est rarement utilisee, de definir en Java des servlets uti- 
lisant un autre protocole de communication. 
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Notez egalement que ces valeurs de parametres sont toujours des chaines de caracteres 
(aucun delimiteur n'apparait). Si des valeurs numeriques doivent etre transmises, la 
servlet devra simplement operer les conversions necessaires. Nous en rencontrerons un 
exemple au paragraphe 4. 

2.1.2 Ecriture de la servlet 

Par rapport a la servlet precedente Bonjour, la seule nouveaute reside dans la recuperation de 
la valeur du parametre prenom. En fait, l'objet de type HttpServletRequest fourni en premier 
argument de doGet contient differentes informations identifiant le client et sa requete. La 
methode getParameter de la classe HttpServletRequest permet de recuperet - (dans une chaine) 
la valeur d'un parametre de nom donne. 

Considerons ce schema : 

public void doGet (HttpServletRequest req, HttpServletResponse rep) 
throws IOException, ServletException 

{ 

Strinq nom = req.qetParameter ("prenom") 

} 

II permet d'obtenir, dans la chaine nom, la valeur fournie par le client pour le parametre 
prenom, lors de l'appel de la servlet. 

Si aucun parametre nomme ainsi n'a ete fourni lors de l'appel, on obtiendra en retour 
de l'appel de getParameter la valeur null. 

Voici ce que pourrait etre le code de notre servlet, en supposant que si le client ne fournit 
aucun prenom, on affiche simplement bonjour : 



import j ava . io . * ; 
import javax. servlet.* ; 
import javax. servlet. http.* ; 



public class BonjourVous extends HttpServlet 

{ public void doGet (HttpServletRequest req, HttpServletResponse rep) 
throws IOException, ServletException 
{ rep . setContentType ("text/html") ; 
PrintWriter page = rep . getWriter ( ) ; 
page.println ("<html>") ; 
page.println ("<head>") ; 

page.println ("<title> Servlet Bonjour </title>") ; 
page.println ("</head>") ; 



String nom = req. getParameter ("prenom") ; 
if (nom == null) 
{ page.println ("<body>") ; 
page.println ("BONJOUR") ; 
page.println ("</body>") ; 

} 



2 - Transmission de parametres a une servlet 



659 



else 

{ page.println ("<body>") ; 

page.println ("<font size=+2>") ; 

page.println ("BONJOUR " + nom) ; 

page.println ("</body>") ; 




La servlet BonjourVous utilisant la methode GET 

2.1.3 Exemple d' execution 

Voici un exemple d'appel de cette servlet, dans lequel le client fournit la valeur "thibault" 
pour le parametre prenom : 



'2 Servlet Bonjour - Microsoft Internet Explorer 






><l 


Fichier Edition Affichage Favoris Outils ? 


sr 


; J Q Precedente ' [*] [2?] \ 


j Rechercher 


Favoris 


%*f> Media 


» 


■ Adresse http://localhost:8080/examples/servlet/BonjourVous?prenom=thibault 


v QoK ; Liens 


» 


Favoris x 
Ajouter... t^j Organis >y 

. Liens 

j*t) Guide des stations de r , , , 


BONJOUR thibault 




■it} Termine 


*J Intranet local 





Appel de la servlet BonjourVous avec un parametre 



Si le client se contente de fournir l'URL de la servlet, sans parametre, il obtiendra simple- 
ment 1' affichage de "BONJOUR". 

2.2 Utilisation d'un formulaire HTML 

Nous avons dit que le recours a un formulaire etait indispensable des lors que les parametres 
etaient transmis par la methode POST. Pour introduire cette notion de formulaire, nous com- 
mencerons par vous montrer comment l'utiliser pour lancer la servlet precedente (bien 
qu'elle n'utilise pas POST, mais GET). 

Un formulaire HTML permet d'effectuer une saisie d' informations dans une sorte de boite de 
dialogue contenant des boites de saisie, des boutons radio, des cases a cocher... II precise ega- 
lement Taction a executer, sous forme de l'adresse d'une page HTML ou d'une servlet (ou 
d'un JSP), ainsi que la methode a employer (GET ou POST) pour transmettre les eventuels 
parametres. 

Par exemple, situee dans le corps d'une page HTML, la balise suivante : 

<input type="text" size=24 name="prenom" value =""> 
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cree une boite de saisie (input) destinee a recueillir du texte, de taille 24, correspondant a un 
parametre nomme prenom et dont la valeur initiale sera une chaine vide. 

De meme, la balise suivante : 

<input type="submit" value="OK"> 

cree un bouton d' action portant la mention OK. 
La balise suivante : 

<form action = http: //localhost: 8080/examples/servlet/BonjourVous method="GET"> 

indique que Taction de l'utilisateur sur le bouton de type "submit" (ici OK) du formulaire entrai- 
nera l'appel de la servlet localhost:8080/examples/servlet/BonjourVous avec la methode GET. 

En definitive, voici ce que pourrait donner la page HTML creant un formulaire de lancement 
de la servlet BonjourVous : 



<html> 
<head> 

<title> Servlet Bon jour Avec Formulaire </title> 
</heao> 
<body> 

<form action = http: //localhost: 8080/examples/servlet/BonjourVous method="GET"> 
Vous vous appelez <input type="text" size=24 name="prenom" value =""> <br> <br> 
<input type="submit" value="OK"> 

</forrrC> 
</body> 
</html> 



Formulaire bonjourForm lancant la servlet BonjourVous avec la methode GET 
Voici un exemple d'appel de ce formulaire HTML : 



'3 Servlet Bonjour Avec Formulaire - Microsoft Internet Explorer 
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Appel du formulaire precedent 
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Et ce que nous obtenons apres avoir clique sur le bouton OK : 



'3 Servlet Bonjour - Microsoft Internet Explorer 



Fichier Edition Affichage Favoris Outils ? 
j Precedente r£j) O) Rechercher 



Adresse /|ocalhost:8080/exarnples/servlet/BonjourVous?prenom=Thomas v OK * 



Favoris x 
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BONJOUR Thomas 


Liens 




-ft*) Guide des stations de r . . . v 




■6^1 Termine 


* j Intranet local 



Exemple d' execution 



On constate que la valeur du parametre prenom apparait bien dans FURL specifiee au naviga- 
teur. 

Remarque 

Ici, l'adresse de la servlet mentionnee dans la balise <action> indiquait le chemin absolu 
d'acces. II est egalement possible d'utiliser un chemin relatif. Par exemple, ici, on obtien- 
drait la meme chose avec action="BonjourVous" . 



Utilisation de la methode POST 

Comme nous l'avons dit, un formulaire devient indispensable pour transmettre des parame- 
tres a une servlet avec la methode POST. Par rapport a l'exemple precedent, quelques diffe- 
rences apparaissent : 

• on cite la methode POST au lieu de la methode GET dans la balise action du formulaire, 

• les informations transmises ne sont plus affichees dans le navigateur, 

• la servlet doit redefinir, non plus la methode doGet, mais la methode doPost qui possede les 
memes arguments. 

En definitive, voici notre nouvelle servlet : 

import java.io.* ; 
import javax. servlet.* ; 
import javax. servlet. http.* ; 



Programmation Java cote serveur : servlets et JSP 

Chapitre 23 



public class Bonj ourVousPost extends HttpServlet 

{ public void doPost (HttpServletRequest req, HttpServletResponse rep) 
throws IOException, ServletException 
{ rep . setContentType ("text /html") ; 
Pr intWriter page = rep . getWriter ( ) ; 
page.println ("<html>") ; 
page.println ("<head>") ; 

page.println ("<title> Servlet Bonjour </title>") ; 
page.println ("</head>") ; 



String nom = req . getParameter ("nam") 
if (nom == null) 
{ page.println ("<body>") ; 

page.println ("BONJOUR") ; 

page.println ("</body>") ; 

) 

else 

{ page.println ("<body>") ; 

page.println ("<font size=+2>") ; 
page.println ( "BONJOUR " + nom) ; 
page.println ("</body>") ; 

} 



La servlet BonjourVousPost utilisant la methode POST 



Voici le nouveau formulaire : 

<html> 
<head> 

<title> Servlet Bonjour Avec Formulaire </title> 
</head> 
<body> 

<form action = http://localhost:8080/examples/servlet/BonjourVousPost method="POST"> 
Vous vous appelez <input type="text" size=24 name="nom" value =""> <br> <br> 
<input type="submit" value="OK"> 

</forrri> 
</body> 
</html> 



Formulaire BonjourFormPost lancant la servlet BonjourVousPost avec la methode POST 
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L'appel de ce formulaire fournit exactement le meme affichage que le precedent. A l'execu- 
tion, le parametre ne s'affiche plus dans le navigateur : 



r — — 

3 Servlet Bonjour - Microsoft Internet Explorer 
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3 Cycle de vie d'une servlet : les methodes init 
et destroy 

Jusqu'ici, nous nous sommes contentes de dire qu'une servlet etait prealablement compilee 
sur le serveur et lancee par la machine virtuelle Java au moment oil un client envoyait une 
requete la concernant. Plus precisement, lors de la premiere requete concernant une servlet 
donnee, il y a instanciation d'un objet correspondant et appel de sa methode init : 

public void init (ServletConf ig conf) throws ServletException 

Par la suite, toute requete concernant la meme servlet, quel que soit le client et quels qu'en 
soient les parametres, est traitee en appelant l'une des methodes doGet ou doPost du meme 
objet. 

Dans ces conditions, on voit qu'il peut etre avantageux de redefinir la methode init en y intro- 
duisant des operations generales telles que les allocations des ressources utiles au fonctionne- 
ment de la servlet (ouvertures de fichiers, de bases de donnees, connexions...). Dans ce cas, 
on n'oubliera pas d'appeler la methode init de la classe de base. 

Si Ton souhaite detruire un objet servlet, il y aura appel de sa methode destroy : 

void destroy () 

II peut etre necessaire de redefinir cette methode si la deallocation des ressources necessite 
un traitement particulier. 

On notera que ce cycle de vie d'une meme servlet est defini par le moteur de servlet. Notam- 
ment, la decision de destruction d'un objet servlet peut etre prise parce qu'il n'a pas ete uti- 
lise pendant un temps donne. 

Voici un exemple de redefinition de init. II s'agit d'une adaptation de la servlet BonjourVous 
precedente, afin qu'elle affiche le nombre de fois oil elle a ete appelee. Pour ce faire, on uti- 
lise une variable compte, initialisee a 0 dans init et incrementee a chaque appel de doGet : 
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import j ava . io . * ; 
import javax. servlet.* ; 
import javax. servlet. http.* ; 

public class Bon j ourVousCompte extends HttpServlet 

{ public void init (ServletConf ig Config) throws ServletException 

{ compte = 0 ; // compteur du nombre cf appels de la servlet 

} 

public void doGet (HttpServletRequest reg, HttpServletResponse rep) 

throws IOException, ServletException 
{ rep . setContentType ("text/html") ; 

PrintWriter page = rep . getWriter ( ) ; 

page.println ("<html>") ; 

page.println ("<head>") ; 

page.println ("<title> Servlet Bonjour comptant ses appels </title>") ; 
page.println ("</head>") ; 
page.println ("<body>") ; 

String nom = req . getParameter ( "prenom" ) ; 
if (nom == null) 
{ page.println ("BONJOUR") ; 

} 

else 

{ page.println ("BONJOUR " + nom) ; 
} 

compte++ ; 

page.println("Appel numero " + compte) ; 
page.println ("</body>") ; 

} 

private int compte ; 



Une servlet comptant ses appels 

Voici cet exemple d'appel : 



3 Servlet Bonjour comptant ses appels Microsoft Internet Explorer 
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4 - Exemple de servlet de calcul de factorielles 





Remarqi 



lues 



1 Supposons que le client effectue un nouvel appel d'une servlet avec les memes valeurs de 
parametres, transmis par la methode GET, autrement dit qu'il fournisse plusieurs fois le 
meme texte dans la barre d'adresse de son navigateur. II est alors probable que le naviga- 
teur ne transmettra pas la seconde requete au serveur car il aura "archive" la page deja 
affichee sur le poste du client et il la retrouvera. Dans ces conditions, le comptage 
d'appels de notre exemple semblera ne pas fonctionner correctement. 

En general, ce phenomene n'apparait pas lorsque les parametres sont transmis par la 
methode POST. 

2 Une meme servlet peut etre appelee par un client alors qu'elle est deja au service d'un 
autre client. II faut savoir qu'en realite le moteur de servlet travaille dans un environne- 
ment dit "multi-thread". Sans entrer dans les details, disons que cela signifie que l'uni- 
que objet servlet cree ainsi que ses champs sont partages par les methodes (telles 
doGet) appelees par les differents clients. Dans certains cas, il pourra etre necessaire de 
"synchroniser" ces methodes ou certaines parties de leur code comme nous avons 
appris a le faire dans le chapitre consacre aux threads. 



4 Exemple de servlet de calcul de factorielles 



Nous vous proposons maintenant une servlet nommee Factorielle, permettant au client d'affi- 
cher les valeurs de factorielles de nombres entiers situes dans un intervalle dont il choisira les 
bornes a l'aide du formulaire HTML suivant (qui propose par defaut l'intervalle de 1 a 5) : 

<html> 
<head> 

<title> Servlet de calcul de factorielles </title> 
</head> 
<body> 

<form action = http://localhost:8080/examples/servlet/Factorielle method="GET"> 
Calcul des factorielles des nombres <brxbr> 
de <input type="text" size=12 name="debut" value ="1"> 
a <input type="text" size=12 name="fin" value ="5"> 
<br><br> 

<input type="submit" value="OK"> 



</ form> 
</body> 
</html> 



Formulaire lancant la servlet de calcul de factorielles 
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Voici comment pourrait se presenter notre servlet : 

import java.io.* ; 
import javax. servlet.* ; 
import javax. servlet. http.* ; 

public class Factorielle extends HttpServlet 

{ public void doGet (HttpServletRequest req, HttpServletResponse rep) 
throws IOException, ServletException 
{ rep . setContentType ("text/html") ; 
PrintWriter page = rep . getWriter ( ) ; 
page.println ("<html>") ; 
page.println ("<head>") ; 

page.println ("<title> Servlet Calcul de Factorielle </title>") ; 
page.println ("</head>") ; 

String sDeb = req. getParameter ("debut") ; 
String sFin = req. getParameter ("fin") ; 
int debut, fin ; 
if (sDeb == null) debut=0 ; 

else debut = Integer. parselnt (sDeb) ; 
if (sFin == null) fin=0 ; 

else fin = Integer .parselnt (sFin) ; 

page.println ("<body>") ; 

page.println ("factorielles de " + debut + " a " + fin + "<br>") ; 
int i = 1, fac = 1 ; 
for ( ; i <= fin ; i++) 
{ fac *= i ; 

if (i >= debut) page.println (i + "! = " + fac +"<br>"); 

} 

page.println ("</body>") ; 

} 

} 

Servlet de calcul de factorielles 

On notera que les parametres obtenus par getParameter etant toujours des chaines, il a ete 
necessaire de les convertir en int a l'aide de la methode parselnt de la classe Integer. 
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L'appel du formulaire se presente ainsi (a gauche, les valeurs proposees par defaut, a droite, 
celles choisies par le client) : 
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On obtient les resultats suivants : 



3 Servlet Calcul de Factorielle - Microsoft Internet Explorer f-""|fn~|[ X 
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Remarque 

Ici, nous n'avons pas cherche a proteger la servlet contre des valeurs de parametres trop 
grands. En pratique, il faudrait probablement, d'une part, utiliser un type long plutot que 
int, d' autre part, s' assurer que la borne superieure ne depasse pas une certaine limite. 

De meme, il serait bon de verifier que les parametres recus sous forme de chaine repre- 
sented bien un entier. 



Q • Qprecedente • [k] ^ (^J) J2> Rechercher 



factonelles de 4 a 8 
4! = 24 
5! = 120 
6! =720 
7! = 5040 
8! =40320 
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5 Premieres notions de JSP 



5.1 Presentation des JSP 

Nous venons de voir comment la creation de pages dynamiques peut etre realisee au moyen 
de servlets. Dans ce cas, un programme Java comporte, entre autres, des instructions specifi- 
ques generant des balises HTML. 

Nous allons voir maintenant que ces pages dynamiques peuvent egalement etre creees par des 
JSP (Java Server Pages) suivant une demarche tres differente. En effet, un JSP est une page 
HTML dans laquelle sont introduits des morceaux de code Java nommes "elements de script". 
On verra qu'il en existe plusieurs sortes, la plus importante etant le scriptlet que nous allons abor- 
der dans ce paragraphe. D'autres elements de script (declarations, commentaires, expressions) 
seront etudies dans les paragraphes suivants. Par ailleurs, nous verrons qu'il existe d'autres bali- 
ses (directives, actions) specifiques aux JSP qui permettent d'en accroitre les possibilites, notam- 
ment au niveau de l'emploi de "JavaBeans" ou de ce que Ton nomme le "suivi de session". 



5.2 Notion de scriptlet 

Pour introduire cette notion de scriptlet, nous commencerons par un exemple tres simple de 
JSP, equivalent a notre premiere servlet Bonjour, c'est-a-dire affichant simplement le mes- 
sage "bonjour". Nous faisons en sorte que cet affichage soit effectivement realise par un 
scriptlet (sinon, nous aurions affaire a une simple page HTML !). 

<html> 
<head> 

<title> JSP Bonjour </title> 
</head> 
<body> 

<% out.println ("BONJOUR") ; 

%> 
</body> 
</html> 



Premier exemple de JSP affichant "BONJOUR" 



Nous avons ici un fichier HTML contenant un scriptlet, a savoir : 

<% out.println ("BONJOUR") ; 

%> 

II s'agit d'un morceau de code Java (reduit ici a une seule instruction) figurant entre les bali- 
ses speciales <% et %>. On note que 1' affichage dans le flux de sortie est realise avec la 
methode println de l'objet out. Ce dernier est, comme System.out de type PrintWriter mais il 
est automatiquement connecte au flux de sortie destine au client. 
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5.3 Execution d'un JSP 



Les JSP sont enregistres avec l'extension .jsp. Pour pouvoir exectuer un JSP, une machine 
serveur doit disposer d'un interpreteur de JSP (ou "moteur de JSP"). Ce dernier est sollicite 
lorsque le serveur recoit une requete de la forme : 

http : //localisationServeur/localisationJSP/nomJSP . j sp? ParametresEventuels 

Lorsqu'il recoit cette requete pour la premiere fois, le moteur de JSP compile le fichier JSP 
correspondant en une servlet (byte codes Java) et en lance 1' execution. Si, par la suite le 
moteur de JSP recoit une nouvelle requete concernant le meme JSP (le client concerne et les 
parametres pouvant etre differents), la servlet en question est directement executee, sans 
qu'aucune nouvelle compilation ne soit necessaire. 

II est tres important de voir que c'est 1' ensemble du JSP qui est compile en servlet, et non 
settlement les scriptlets. Ainsi, toutes les balises ou textes figurant en dehors des scriplets sont 
prealablement traduits en instructions Java sous la forme : 

out . println ( " texte_ou_balise_HTML" ) 

Ainsi, le concepteur de JSP aura souvent a choisir entre 1' utilisation de out dans un scriptlet 
et l'introduction directe de balises ou texte HTML. Bien exploitee, cette dualite pourra per- 
mettre d'ameliorer la clarte des JSP mais elle pourra aussi conduire a des choses tres confu- 
ses. Par exemple, ce JSP realise la meme chose que le precedent : 

<html> 
<head> 

<% out. println ("<title> JSP Bonjour </title>") ; %> 
</head> 
<body> 

<% out. println ("BONJOUR") ;%> 

</body> 

<% out. println ("</html>") ; %> 



II est possible, generalement, de visualiser le code Java genere par le moteur de JSP. 
Sachez alors que les classes et methodes employees ne portent pas les memes noms que 
celles que vous utilisez pour ecrire une servlet, meme si, au bout du compte, elles ont des 
roles similaires. 



6 Transmission de parametres a un JSP : 
I'objet request 



Nous avons vu comment le protocole HTTP disposait de deux facons pour lancer une requete 
du client au serveur : 



JSP "confus", equivalent au precedent (paragraphe 5.2) 




Remarque 
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• la methode GET : les parametres eventuels sont transmis dans l'URL fournie au navigateur, 

• la methode POST : les parametres eventuels sont transmis separement. 

Nous avons appris a lancer ces requetes cote client en utilisant eventuellement un formulaire 
HTML. Nous avons vu comment le serveur pouvait repondre a ces requetes a Faide de ser- 
vlets. Nous allons maintenant voir comment il peut egalement repondre a ces memes reque- 
tes a Faide de JSP. 

Dans un JSP, on peut utiliser un certain nombre d'objets predefinis, en particulier Fobjet 
request, de type HttpServletRequest (deja rencontre), identifiant le client et sa requete. 
II suffit de recourir a la methode getParameter pour obtenir les valeurs des parametres 
comme nous l'avions fait avec une servlet. Rappelons qu'il s'agit de chaines ayant la valeur 
null en cas d' absence de parametre. 

Voici un JSP nomme bonjourVous donnant le meme resultat que notre servlet BonjourVous : 

<html> 
<head> 

<title> JSP Bonjour </title> 
</head> 
<body> 
<% 

String nom = request . getParameter ("prenom") ; 
if (nom == null) 
{ 

out.println ("BONJOUR") ; 

} 

else 
{ 

out.println ( "BONJOUR " + nom) ; 

} 

%> 

</body> 
</html> 

JSP bonjourVous jsp 

On notera que, dans une servlet, il etait necessaire de savoir comment les parametres etaient 
transmis de fa5on a redefinir, soit la methode doGet, soit la methode doPost. Dans le cas du 
JSP, cette distinction n'existe plus. Si Ton s'interessait a la servlet generee par un JSP, on 
constaterait qu'elle est formee essentiellement d'une methode (nommee souvent 
JspService). 

Pour executer notre JSP nous pouvons indifferemment : 
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saisir l'adresse du JSP dans le navigateur, en l'accompagnant de la valeur du parametre 
prenom : 



'3 JSP Bonjour - Microsoft Internet Explore 


r 






Fichier Edition Affichage Favoris Outils ? 




J 


0 Qprecedente - \x\ \£\ \ 


j '■ Rechercher 


Favoris 


» 

^ Media 



: Adresse | ijg) http : //local host : 8080/examples/bon jourVous , jsp?prenom=thomas v 
Favoris x 



OK : Liens 



[Qfj Ajouter.,. tfj Organis 



Q Liens 
Termine 



BONJOUR thomas 



"J Intra 



utiliser un formulaire HTML comparable a l'un de ceux presentes au paragraphe 2.2 ; notez 
que, bien que la methode de transmission des parametres (GET ou POST) n'intervienne pas 
dans Fecriture du JSP, celle-ci doit etre precisee dans le formulaire HTML. Par exemple, 
nous pourrons proceder ainsi : 



<html> 
<head> 

<title> Appel de JSP bonjourVous </title> 
</head> 
<body> 

<form action = http: //localhost : 8080/examples/bonjourVous . jsp method=GET> 
Vous vous appelez <input type="text" size=24 name="prenom" value =""> 
<input type="submit" value="OK"> 

</ fornt> 
</body> 
</html> 

Formulaire de lancement du JSP bonjourVous 

7 Les differents elements de script d'un JSP 

Nous allons tout d'abord apporter des precisions sur les scriptlets en etudiant les possibilites 
algorithmiques qu'elles permettent de mettre en ceuvre. Puis nous etudierons d'autres ele- 
ments de script : les expressions, les commentaires et les declarations. 
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7.1 Possibilites algorithmiques des scriptlets 

Les exemples precedents pourraient etre qualifies de "sequentiels" dans la mesure ou ils ne 
faisaient intervenir aucune structure de controle. Mais un scriptlet peut contenir n'importe 
quel code Java dont, en particulier, des instructions structurees. Dans ce cas, il n'est pas 
necessaire que l'ensemble d'une instruction structuree figure dans un meme scriptlet. 

Ainsi, avec : 

<% for (int i=0 ; i<5 ; i++) 
{ cout.println ("EONJOUR") ; 

} 

%> 

on obtient 5 fois BONJOUR dans la page transmise au client. Mais on peut aussi proceder 
ainsi : 

<% for (int i=0 ; i<5 ; i++) 
{ 

%> 

EONJOUR 

<% } 

%> 

Un premier scriptlet contient le debut de 1' instruction for, un second la fin. Entre les deux 
figures, du texte HTML qui sera incorpore tel quel (mais ici 5 fois !). 

Nous verrons un peu plus loin un exemple utilisant l'instruction Pour l'instant, on voit deja 
que ces possibilites permettent d'appliquer des structures de controle a des balises HTML. 

7.2 Les expressions 
7.2.1 Introduction 

Nous avons deja vu la dualite qui existe entre l'instruction Java : 

out.println ("texte") ; 

dans un scriptlet et le meme texte figurant directement dans le fichier JSP sous forme HTML. 

Mais cette dualite concernait de simples textes. Considerons, en revanche, une instruction 
telle que : 

out.println ("EONJOUR" + nom) ; 

Ici, on peut toujours introduire le texte BONJOUR dans le JSP mais on ne sait pas le faire 
pour la valeur de la variable nom. Bien sur, on peut toujours proceder ainsi : 

BONJOUR 
<% out.println (nom) ; 

%> 

Mais la notion d'expression simplifie les choses puisqu'elle permet d'introduire la valeur 
d'une expression Java dans le flux HTML sous la forme suivante (notez bien le signe =) : 

<%= expression %> 
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On voit done que l'instruction : 

out.println ("EONJOUR" + nom) ; 

d'un scriptlet peut etre remplacee par la ligne HTML suivante : 

EONJOUR <%= nom %> 

7.2.2 Exemples 

Dans notre exemple de JSP du paragraphe 6, nous avions place toute la generation du corps 
(BODY) de la page HTML dans une seule scriptlet. Nous aurions egalement pu chercher a 
n'utiliser le code Java que pour la partie dynamique de la page (ici le prenom), ce qui nous 
aurait alors conduit a un JSP de ce genre : 

<html> 
<head> 

<title> JSP Eonjour </title> 
</head> 
<body> 

<% String nom = request . getParameter ("prenom") ; 
if (nom == null) 
{ 

%> 

EONJOUR 
<% } 
else 
{ 

%> 

EONJOUR <%= nom %> 
<% } 

%> 
</body> 
</html> 

JSP utilisant des expressions (1) 
Ici, nous avons trois scriptlets et deux textes HTML : 

EONJOUR 

EONJOUR <%= nom %> 

Notez qu'il est possible d'ecrire notre JSP de fafon plus lisible, en procedant ainsi : 

<html> 
<head> 

<title> JSP Bon jour </title> 
</heao> 



<body> 

<% String nom = request. getParameter ("prenom") ; 

if (nom == null) nom = "" ; // si pas de parametre, on cree une chaine vide 

%> 

BON JOUR <%= nom %> 
</body> 
</html> 

JSP utilisant des expressions (2) 

Nous avons separe ce qui concernait les calculs Java relatifs a la page (on parle souvent 
d' implementation) de sa presentation proprement dite. Pour y parvenir, nous avons convenu 
de fournir une chaine vide (et non plus de valeur null) en cas d'abscence de parametre. 

7.2.3 Les expressions d'une maniere generale 

Dans l'element de script <%= expression %>, on peut placer n'importe quelle expression 
valide en Java, pour peu qu'elle puisse etre convertie en chaine. Bien entendu, toutes les 
expressions numeriques sont dans ce cas. Mais on peut aussi recourir aux methodes d'objets 
(predefinis ou non), comme dans cet exemple : 

BONJOUR <%= out . getParameter (prenom) %> 

On notera cependant qu'une erreur peut survenir pendant 1' execution de la servlet generee si 
le parametre prenom est absent car la methode println ne peut pas recevoir un argument de 
valeur null. Notez que cela ne se produira pas si le JSP est lance par un formulaire convena- 
ble. 

D'une maniere generale, n'oubliez pas que tout objet dispose d'une methode toString (au 
moins de celle par defaut heritee de Object) permettant d'en convertir la valeur en chaine. 

7.3 Commentaires 

On peut bien entendu introduire des commentaires Java dans les scriptlets. Mais on peut ega- 
lement introduire des commentaires JSP sous la forme : 

<% — ceci est un commentaire — %> 

Voici une version commentee de notre JSP precedent bonjourVous. 

<% — calcul de la chaine correspondant au prenom (vide si pas fourni) — %> 

<% 

String nom = request. getParameter ("prenom") ; 

if (nom == null) nom = "" ; // si pas de parametre, on cree une chaine vide 

%> 

<% — page HTML utilisant la valeur de 1' expression nom — %> 
<html> 
<head> 

<title> JSP Bonjour </title> 
</head> 
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<body> 

EONJOUR <%= nom %> 
</body> 
</html> 

JSP bonjourVous commente 

7.4 Les balises de declaration 

7.4.1 Presentation 

II existe un element de script de la forme : 

<% ! Declarations Java %> 

II permet d'introduire des decarations de variables ou de methodes. A priori, une telle possi- 
bility peut sembler redondante par rapport aux scriptlets qui permettent, eux-aussi, d'effec- 
tuer de telles declarations. 

En fait, il faut voir que tout le code Java des scriptlets est incorpore dans une seule methode 
(nommee generalement JspService) de la servlet resultant de la compilation du JSP. II s'agit 
de la methode appelee en reponse a une requete du client. 

Ainsi une variable declaree dans un scriptlet est une variable locale a cette unique 
methode. 

En revanche, les declarations fournies dans la balise <%= ... %> vont figurer en dehors de 
cette methode, dans la classe elle-meme. Elles correspondent done a des champs (variables 
d'instance) ou a des methodes de la classe. 

7.4.2 Exemple de declaration de variables d'instances (champs) 

Nous pouvons ecrire un JSP equivalent a la servlet comptant ses appels presentee au paragra- 
phe 3. Pour ce faire, nous declarons une variable compte jouant le meme role que la variable 
compte de la servlet en question. 



<html> 
<heao> 

<title> JSP Bonjour comptant ses appels </title> 
</heao> 
<body> 

<%! int compte=0 ; %> 

<% String nom = request . getParameter ("prenom") ; 
if (nom == null) 
{ out.println ("BONJOUR") ; 
} 

else 

{ out.println ("EONJOUR " + nom) ; 
} 
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compte++ ; 

out.println ("numero : " + compte) ; 

%> 

</body> 
</html> 



JSP comptant ses appels (1) 

On peut obtenir une presentation plus lisible separant F implementation de la presentation en 
modifiant legerement le code de determination du prenom comme nous Favons deja fait 
(chaine eventuellement vide et plus de valeur null) : 

<% — code Java de determination du prenom et de comptage des appels — %> 
<%! int compte=0 ; // nombre oY appels %> 

<% String nom = request . getParameter ("prenom") ; 

if (nom == null) nom = "" ; 

compte+t ; 

%> 

<% — construction de la page HTML — %> 
<html> 
<head> 

<title> JSP Bonjour comptant ses appels </title> 
</head> 
<body> 

BONJOUR <%= nom %> 

<BR> <BR> 

APPEL numero : <%= compte %> 
</body> 
</html> 

JSP comptant ses appels (2) 



Remarques 

1 Si nous declarons la variable compte dans un scriptlet, nous constaterons que le JSP affi- 
che toujours la meme valeur (1). 

2 La remarque du paragraphe 3 concernant le comportement du navigateur en cas 
d' appels successifs d'une servlet avec les memes valeurs de parametres s' applique tout 
naturellement aux JSP. II en va de meme pour la remarque concernant les problemes de 
synchronisation rencontres en cas d' appels simultanes d'un meme JSP par differents 
clients. 
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7.4.3 Declarations de methodes d'instance 

On notera qu'une declaration de methode n'aurait pas de sens dans un scriptlet (puisque les 
methodes locales a une methode n'existent pas en Java). Ceci conduirait a une erreur au 
moment de la compilation du JSP : 

<% void salutO { out.println ("Bonjour") ; } %> <% — script incorrect — %> 

En effet, le code genere serait introduit dans la methode JspService. 
En revanche, avec : 

<%! void salutO { out.println ("Bonjour") ; } %> <% — declaration correcte — %> 

on cree dans la classe servlet generee par le JSP une methode d'instance nommee salut. Elle 
sera utilisable par n'importe quelle autre methode de la classe. 

Nous rencontrerons un exemple de methode d'instance dans le paragraphe 7.5. 

7.4.4 Les balises de declaration en general 

L' emplacement de la balise <%! ... %> dans le JSP n'est pas important, pas plus que ne 
l'etait l'emplacement de la declaration d'un champ ou d'une methode au sein d'une classe. 
Un champ ou une methode ainsi declares peuvent etre references de n'importe quel emplace- 
ment du JSP meme s'il se situe apres ladite declaration. 

En revanche, le contenu d'une telle balise doit former une ou plusieurs declarations comple- 
tes. Par exemple, cette declaration est correcte : 

<%! int n ; String hello () { return ("BONJOUR") ; } %> 

En revanche, celle-ci est incorrecte : 

<%! int %> <% — incorrect — %> 



<%! n ; %> 

7.5 Exemple de JSP de calcul de factorielles 

Nous vous proposons de reprendre sous forme de JSP 1' exemple de servlet de calcul de facto- 
rielles. II sera lance indifferemment par un formulaire ou en specifiant les valeurs des para- 
metres dans le navigateur (rappelons que la distinction entre les methodes GET et POST n'a 
plus de raison d'etre dans le cas des JSP). 

<% — code de determination des valeurs debut et fin — %> 
<% String sDeb = request . getParameter ("debut") ; 
String sFin = request . getParameter (" fin" ) ; 
int debut, fin ; 
if (sDeb == null) debut=l ; 

else debut = Integer. parselnt (sDeb) ; 
if (sFin == null) fin=4 ; 

else fin = Integer .parselnt (sFin) ; 

%> 
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<% — construction de la page HTML — %> 
<html> 
<head> 

<title> JSP Calcul de factorielles </title> 
</head> 
<body> 

Factorielles de <%= debut %> a <%= fin %> <br> 
<% int i = 1, fac = 1 ; 
for ( ; i <= fin ; i++) 
{ fac *= i ; 
if (i >= debut) 
{ 

%> 

<%= i %> ! = <%= fac %> <br> 
<% } 
} 

%> 

</body> 
</html> 



75P de calcul de factorielles (1) 

L'exemple est peu lisible, compte tenu d'une trop grande imbrication entre les parties presen- 
tation et implementation. On peut ameliorer la situation en recourant a une methode d' ins- 
tance calculant la factorielle d'un entier (on perd sur Fefficacite des calculs !) : 

<% — methode de calcul de factorielle — %> 
<%! int fact (int n) 
{ int fac = 1 ; 

for (int i=l ; i<=n ; i++) fac *= i ; 
return fac ; 

} 

%> 



<% — code de determination des valeurs debut et fin — %> 

String sDeb = request. getParameter ("debut") ; 
String sFin = request. getParameter ("fin") ; 
int debut, fin ; 
if (sDeb == null) debut=l ; 

else debut = Integer. parselnt (sDeb) ; 
if (sFin == null) fin=4 ; 

else fin = Integer .parselnt (sFin) ; 
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<% — construction de la page HTML — %> 
<html> 
<head> 

<title> JSP Calcul de factorielles </title> 
</head> 
<body> 

Factorielles de <%= debut %> a <%= fin %> <br> 
<% for (int i=debut ; i <= fin ; i++) 
{ 

%> 

<%= i %>! = <%= fact(i) %> <br> 

<% } 
%> 

</body> 
</html> 

75P c/e calcul de factorielles (2) 

8 Utilisation de JavaBeans dans des JSP 

8.1 Introduction a la notion de JavaBean 
8.1.1 Utilisation d'un objet usuel dans un JSP 

A priori, dans un JSP, on peut utiliser des objets. lis peuvent etre instancies a partir de classes 
predefinies (telles que Integer, ArrayList...) ou de classes definies par Futilisateur. Supposez 
qu'on souhaite utiliser un objet d'une classe Prenom pour y conserver un prenom. La classe 
Prenom pourrait posseder un constructeur sans argument et deux methodes, l'une pour fixer 
le prenom, 1' autre pour Fobtenir. Elle pourrait se presenter ainsi : 

public class Prenom 
{ public Prenom () 

{ prenom = "" ; 

} 

public void setPrenom (String pr) 
{ prenom = pr ; 

} 

public String getPrenom () 

{ return prenom ; 

} 

String prenom ; 

} 



Classe Prenom destinee a representer un prenom 
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On pourrait ecrire un JSP recuperant un prenom en parametre et le conservant dans un objet 
de type Prenom. Pour simplifier, supposez qu'on souhaite adapter dans ce sens notre JSP 
BonjourVous.jsp du paragraphe 6 (dans la pratique, ce JSP devrait faire d'autres choses avec 
le prenom pour que la demarche proposee ici soit interessante). Si la classe Prenom a ete 
compilee separement 1 , le JSP pourrait se presenter ainsi : 

<html> 
<head> 

<title> JSP Bonjour avec une classe Prenom </title> 
</head> 
<body> 

<% Prenom pr ; // declaration d' un objet local du type classe Prenom 

String s = request . getParameter ("prenom") ; // recuperation parametre prenom 
if (nom != null) pr . setPrenom (s) ; 

%> 

BONJOUR <%= pr . getPrenom ( ) %> 
</body> 
</html> 



JSP utilisant la classe Prenom 

8.1.2 Utilisation d'un objet de type JavaBean 

Dans notre exemple precedent, l'utilisation de l'objet de type Prenom nous oblige a recourir 
a des elements de script (ici scriptlet et expression). 

Mais les JSP disposent de balises specifiques qui permettent d'utiliser directement des objets 
sans avoir besoin de faire appel a des instructions Java, simplement en les manipulant par le 
biais de balises particulieres. Pour cela, il suffit que les objets en question soient ce que Ton 
nomme des JavaBeans, autrement dit que leur classe reponde a quelques criteres simples, a 
s avoir : 

• disposer d'un constructeur sans arguments, 

• disposer de methodes d'acces de la forme getXXX et de methodes d' alteration de la forme 
setXXX, XXX designant une propriete du JavaBean. 

On notera que si XXX peut representer le nom d'un champ de la classe, cela n'est pas obliga- 
toire, dans la mesure oil un objet de la classe peut representer une telle propriete comme bon 
lui semble. De meme, il n'est pas necessaire que toutes les proprietes disposent d'une 
methode d'alteration et d'une methode d'acces. 

On voit que la classe Prenom precedente peut tout a fait etre utilisable comme un JavaBean. 
Un objet de ce type possede une seule propriete prenom et des methodes setPrenom et get- 
Prenom. Supposons que nous l'avons reecrite sous le nom PrenomBean pour respecter des 



1 . En toute rigueur, on pourrait egalement faire figurer la definition de la classe dans un scriptlet ou une balise 
de declaration mais cela n'en faciliterait pas la reutilisation ! 
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regies utilisees tacitement avec les beans (mais non obligatoires). En outre, comme le requie- 
rent certains moteurs de servlets, nous placons cette classe dans un package (nomme ici 
beans) : 

package beans ; 

public class PrenomBean 

{ public PrenomBean () 

{ prenom = "" ; 

} 

public void setPrenom (String pr) 
{ prenom = pr ; 

} 

public String getPrenom () 

{ return prenom ; 

} 

String prenom ; 

} 

Classe JavaBean nommee PrenomBean appartenant a un package nomme beans 

Voici alors comment reecrire le JSP precedent, sans utiliser d' instructions Java, en recourant 
simplement aux trois balises specifiques aux JavaBeans, a savoir jsp:useBean, jsp:setPro- 
perty et jsp:getProperty : 

<% — creation d' un objet de type PrenomBean — %> 
<jsp:useBean id="objetPrenom" class="beans . PrenomBean" /> 
<head> 

<title> JSP Essai Bean </title> 
</head> 
<body> 

<jsp:setProperty name="objetPrenom" property="prenom" value="Thibault" /> 
EONJOUR <jsp:getProperty name="objetPrenom" property="prenom" /> <br> 
</body> 
</html> 

JSP utilisant un bean de type PrenomBean 

La balise : 

<jsp:useBean id= "objetPrenom" class= "beans. PrenomBean" /> 
fait appel a la classe beans. PrenomBean pour instancier un objet de nom objetPrenom. 
La balise : 

<jsp:setProperty name= "objetPrenom " property = "prenom " value= "Thibault" /> 
donne a la propriete nommee prenom de F objet objetPrenom la valeur "Thibault". 
Enfin, la balise : 
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<jsp:getProperty name = "objetPrenom " property = "prenom " /> 
fournit la valeur de la propriete nommee prenom de Fobjet objetPrenom. 

8.2 Utilisation directe de parametres dans des JavaBeans 

Dans notre exemple precedent, la valeur de la propriete prenom etait fournie explicitement 
dans la balise jsp:setProperty sous la forme value = ... II existe une variante de cette balise 
qui permet d'utiliser la valeur d'un des parametres recus par le JSP, sous la forme 
param="nomParametre". En voici un exemple dans lequel nous utilisons toujours la classe 
PrenomBean precedente : 

<% — creation d un objet de type PrenomBean — %> 
<jsp:useBean id=" objetPrenom" class="beans . PrenomBean" /> 

<% — on initialise le champ prenom avec la valeur du parametre prenom — %> 
< j sp: setProperty name=" objetPrenom" property="prenom" par am= "prenom" /> 
<html> 
<head> 

<title> JSP Essai Bean 2 </title> 
</head> 
<body> 

<% — on affiche la valeur du champ prenom de 1' objet objetPrenom — %> 
EONJOUR <jsp:getProperty name="objetPrenom" property="prenom" /> <br> 
</body> 
</html> 

Exemple a" utilisation de parametres dans un JavaBean 

On notera la concision de l'ecriture : cette fois, nous n'avons pas eu besoin de recuperer la 
valeur du parametre prenom comme nous Favions fait dans les precedents exemples (par 
request. getParameter). 

8.3 Exemple d'utilisation d'une classe Point transformee 
en JavaBean 

Nous vous proposons de realiser une classe nommee PointBean comportant trois proprietes : 
abs (abscisse), ord (ordonnee) et norme (distance du point a Forigine). 

package beans ; 
public class PointBean 
{ public PointBean () 

{ abs=0 ; ord=0 ; 

} 

public int getAbs () 
{ return abs ; 
} 
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public int getOrd () 
{ return ord ; 
} 

public void setAbs (int abs) 
{ this . abs = abs ; 
} 

public void setOrd (int ord) 
{ this . ord = ord ; 
} 

public double getNorme () 

{ return Math.sqrt (abs* abs + ord* ord) ; 
} 

private int abs, ord ; 

} 

JavaBean nomine PointBean 

On notera qu'ici, les proprietes abs et ord disposent de methodes d'acces et d' alteration tan- 
dis que la propriete norme ne dispose que d'une methode d'acces. 

Voici un petit exemple de JSP utilisant ce JavaBean : 

<% — creation d' un objet de type PointBean — %> 
<jsp:useBean id="pointl" class="beans . PointBean" /> 

<% — on initialise les coordonnees avec les valeurs des parametres x et y — %> 
<jsp:setProperty name="pointl" property="abs" param="x" /> 
<jsp:setProperty name="pointl" property="ord" param="y" /> 

<html> 
<head> 

<title> JSP Essai Bean de type PointBean </title> 
</head> 
<body> 

Le point de coordonnees (<jsp:getProperty name="pointl" property="abs" /> , 

<jsp:getProperty name="pointl" property="ord" />) <br> 
a pour norme <j sp : getProperty name="pointl" property="norme" /> <br> 

</body> 
</html> 



JSP utilisant PointBean 
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En voici un exemple d'utilisation dans lequel on fournit directement les parametres (x et y) 
dans le navigateur : 



— ' ■ — -- 
^ JSP Essai Bean de type Point Bean • Microsoft Internet Explorer - □ 
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» 
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Le point de coordonnees (3 , 12) 
apournorme 12.36931687685298 




Ci£ Nouveau < 


*n m <\ V 
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8.4 Portee d'un JavaBean 
8.4.1 Notion de suivi de session 

A priori, un JavaBean est cree dans une page JSP et il est accessible dans la page correspon- 
dante. Autrement dit, l'objet est cree dans la methode JspService de la servlet obtenue par 
compilation du JSP. 

II est cependant possible d'en modifier la portee, soit dans le sens d'une restriction (portee 
request), soit dans le sens d'un elargissement (portees session ou application). 

La possibility la plus interessante est manifestement l'extension de la portee a une session. 
Pour en voir l'interet, il faut savoir que, dans le protocole HTTP, la communication a toujours 
lieu en mode "deconnecte". La notion de connexion d'un client (qui semble aller de soi 
quand on se situe du cote client) lui est totalement etrangere : d'une requete a une autre (du 
meme client), le serveur ne conserve aucune trace du client ou de ses requetes. Tout se passe 
comme s'il s'agissait a chaque fois d'un nouveau client. 

Dans ces conditions, il semble impossible de realiser une simple application de gestion des 
commandes d'un client (on parle souvent de "caddie electronique"), puisque celle-ci met 
generalement en ceuvre plusieurs requetes. II en va de meme pour des applications souhaitant 
creer des pages specialisees adaptees au "profil" de chaque client. 

En fait, on a mis au point des techniques dites de "suivi de session" permettant de conserver 
des informations sur un client, d'une de ses requetes a une autre. Les plus courantes sont : 

• les "cookies" (ou "temoins") : on nomme ainsi des informations que le serveur transmet au 
navigateur du client pour qu'il les conserve afin de les retransmettre lors d'une prochaine 
requete au meme serveur (parfois au meme groupe de serveur...) ; 

• la reecriture d'URL : ici, sur demande du serveur, le navigateur fournit un "numero de ses- 
sion" qu'il ajoute comme parametre des requetes suivantes au meme serveur. 
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On notera que si le debut de session est parfaitement defini, il n'en va pas de meme pour sa 
fin. En general, le serveur decide de mettre fin a une session, suite a une absence de requetes 
du client pendant une certaine duree. 

8.4.2 Suivi de session avec les JSP et les JavaBeans 

L'avantage des balises JSP relatives aux JavaBeans est d'offrir des possibilites de suivi de 
session transparentes au concepteur des pages. En effet, un JavaBean declare simplement 
avec la portee session sera conserve pendant toute la duree de la session avec le client et sera 
accessible depuis toutes les pages JSP concernees, c'est-a-dire celles qui l'auront declare 
sous cette forme : 

<jsp:useBean id = " "class = " "scope = "session" /> 

8.4.3 Les differentes portees d'un JavaBean 

Voici la description succincte des differentes portees qu'on peut attribuer a un JavaBean : 



Portee 


Signification 


request 


La portee du JavaBean est reduite au traitement de la requete. Un nouvel objet 
est done cree a chaque nouvelle requete 


page 


II s'agit de la portee par defaut ; I'objet a une portee identique a celle de I'objet 
servlet resultant de la compilation du JSP, au meme titre qu'une simple varia- 
ble d'instance 


session 


La portee du JavaBean est etendue a toute la session avec un meme utilisa- 
teur 


application 


La portee du JavaBean est etendue a toute I'application du serveur. II est done 
partage entre toutes les pages JSP executees sur le serveur. 



Portee d'un JavaBean 



8.5 Informations complementaires sur les JavaBeans 

Dans un Bean, certaines proprietes sont accessibles uniquement en consultation et ne sont 
pas modifiables par Futilisateur. C'etait le cas de la propriete norme de notre classe Point- 
Bean. 

Rappelons qu'il n'est pas necessaire qu'a une propriete soit associe un champ. Notre classe 
PointBean est bien dotee d'une propriete norme alors qu'aucun champ ne lui est associe. 

L'echange d' informations dans les balises JSP de communication avec les JavaBeans se fait 
toujours par le biais de chaines {String). Cela signifie que des conversions sont automatique- 
ment mises en place. Lorsqu'on fixe ainsi la valeur d'une propriete, il est necessaire que la 
conversion correspondante soit possible. 

Nos exemples montraient des JavaBeans plutot statiques : on y rangeait de F information 
qu'on pouvait retrouver plus tard (eventuellement transformee). En fait, un Bean peut tres 
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bien executer une action pour peu que celle-ci soit declenchee par une des methodes accessi- 
bles au JSP. Par exemple, notre classe PointBean pourrait associer un champ norme a la pro- 
priete de meme nom et en lancer le recalcul a chaque fois que Ton appelle Fune des 
methodes d' alteration setAbs ou setOrd. Un JavaBean d'acces a une base de donnees de 
clients peut tres bien lancer la consultation de la base pour trouver les caracteristiques d'un 
client a chaque fois qu'on en definit le nom. Pour traduire ce phenomene, on parle parfois de 
"proprietes liees" ou de "proprietes de declenchement". 

Un JavaBean peut disposer d'autres methodes que celles correspondant a ces proprietes. 
Mais elles ne pourront plus etre utilisees par le biais de balises JSP mais en recourant a des 
elements de script. 

On demandera souvent a un JavaBean d'implementer l'interface Serializable. Celle-ci per- 
met d'echanger des objets ou de le stocker dans un fichier pour les restituer ulterieurement. 

Les valeurs fournies pour une propriete dans la balise jsp:setProperty peuvent etre, non seu- 
lement des constantes chaines comme dans nos exemples, mais n'importe quelle expression 
Java fournissant un resultat de ce type. 

9 Possibilites de composition des JSP 

Dans un ouvrage consacre a Java, il n'est pas question de traitor en details les JSP. Toutefois, 
nous resumons ici quelques points forts des JSP lorsqu'il s'agit de developper des applica- 
tions regroupant plusieurs pages. 

9.1 Inclusion statique d'une page JSP dans une autre 

La balise : 

<%@ include file = "ReferencePageJSP" /> 

recopie le texte de la page JSP mentionnee a l'emplacement oil elle figure. Elle s'apparente a 
l'inclusion de fichiers en-tetes en C ou en C++. II s'agit ici d'une simple recopie de texte, 
avant compilation des JSP concernes. 

9.2 Chamage de JSP 

On peut deja chainer des JSP comme on le fait avec des pages HTML a l'aide de liens hyper- 
texte. Mais la balise de chainage jsp:forward offre des possibilites plus riches puisque le 
chainage peut etre conditionnel, voire iteratif et, de plus, assorti de parametres (par name et 
value) qui sont transmis d'un JSP a l'autre. 

Voici un exemple de chainage conditionnel avec parametres : 
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<% — on suppose que les variables locales codeAnomalie et conditionAnomalie existent - 

-%> 



<% — test anomalie — %> 
<% if (conditionAnomalie) 
{ codeAnomalie = ; 

%> 

<% — renvoi a un JSP traitant 1' anomalie — %> 
<jsp:forward page="PageAnomalie. jsp" > 

<jsp:param name="code" value="CodeAnomalie" /> 

<% } 

%> 

<% — traitement normal — %> 



9.3 Inclusion dynamique de JSP 

On peut utiliser le code Java d'un JSP dans un autre (apres compilation, cette fois) a Faide de 
la balise jsp:include. Elle dispose du meme mecanisme de parametres que la balise 
jsp:forward. 

Cette fois, le mecanisme s'apparente a un appel de fonction (il y a bien retour dans le JSP 
appelant) avec eventuel transfert d' arguments. 

II permet done veritablement un developpement modulaire. 

10 Architecture des applications Web 

Ici, nous vous avons presente les notions de servlet d'une part, de JSP d'autre part, en utili- 
sant des "exemples d'ecole". Dans une application reelle, il sera generalement necessaire 
d'exploiter les deux concepts et, comme on a deja pu l'entrevoir sur nos simples exemples, 
un manque d'organisation risque de conduire a des codes incomprehensibles. On aura alors 
interet a s'appuyer sur un "motif de conception" 1 particulier nomme "Modele Vue Contro- 
leur", dans lequel les responsabilites sont clairement reparties entre : 

• le modele qui correspond aux donnees de 1" application, 

• la vue qui fournit une representation visuelle, sous forme de pages Web, 

• le controleur qui definit la vue ou la modifie, en fonction des donnees et des requetes de 
Futilisateur. 

En general, la vue est ecrite en JSP, tandis que le controleur Test sous forme d'une servlet ; 
les acces aux donnees sont realises par des JavaBeans. 



1 . Design pattern en anglais. 
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Mais, meme dans une telle architecture, va apparaitre souvent le besoin d'effectuer un "traite- 
ment" dans la definition de la page Web (vue) presentee a l'utilisateur, ne serait-ce qu'une 
boucle sur les elements d'un tableau (afin d'en afficher les differentes valeurs). Dans ce cas, 
les choses seront facilities par l'utilisation de JSTL (JSP Standard Tag Library) qui fournit 
des balises (tag) standards JSP remplacant du code Java. De plus, JSP, dans sa version 2, a 
introduit la notion d'EL (Expression Langage), laquelle permet d'introduire directement la 
valeur d'une expression dans JSP sans passer par du code Java. 

Neanmoins, dans des applications reelles, le code obtenu ne sera pas encore satisfaisant sur le 
plan de la separation des actions et, done, de son adaptabilite. II suffit de songer au simple 
remplissage d'un formulaire en ligne oil se posent des problemes de reaction immediate, en 
cas de saisie d'une valeur incorrecte ou de navigation entre plusieurs pages... II faudra alors 
se tourner vers des outils plus puissants comme les JSF (Java Server Faces). 
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L introspection et 
les annotations 



Java dispose de possibilites tres puissantes dites d'introspection (ou de reflexion) qui permet- 
tent d' analyser les caracteristiques d'une classe ou d'un objet, pendant l'execution. Par 
ailleurs, avec Java 5 sont apparues les annotations, sortes de marques parametrees qu'il est 
possible d'accoler, par exemple, a une classe ou une methode, en vue des les faire exploiter 
ulterieurement par des outils logiciels specialises. Certaines de ces annotations peuvent etre 
analysees au moment de l'execution, par des mecanismes d'introspection ; c'est ce qui justi- 
fie la presence de ces deux notions (introspection et annotations) dans un meme chapitre. 

Nous commencerons par presenter les possibilites d'introspection en introduisant le type 
Class, sorte de super-type dont les instances sont des classes. Puis nous verrons comment 
obtenir des informations sur les champs ou methodes d'une classe ou meme d'un objet dont 
on ne connait pas le type. 

Puis nous presenterons la notion d' annotation, en montrant tout d'abord comment proceder 
pour definir une nouvelle annotation et l'utiliser. Nous montrerons ce que sont les parametres 
d'une annotation et comment leur attribuer des valeurs par defaut. Nous verrons comment 
agir sur la "duree de vie" d'une annotation et comment imposer la nature des elements aux- 
quels elle peut s'appliquer. Nous presenterons les "annotations standards". 

Enfin, nous verrons comment exploiter des annotations par introspection. 
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1 Les bases de l'introspection : le type Class 

Jusqu'ici, nous avons manipule des objets qui etaient des instances d'une classe. Mais Java 
permet egalement de manipuler des classes, qu'il considere alors comme des objets d'un 
"super-type" nomme Class (attention au C majuscule). Nous verrons bientot qu'un tel super- 
type dispose de methodes fournissant des informations sur ses instances qui sont des "super- 
objets" (puisque ce sont des classes), par exemple : noms de champs, noms de methodes, 
types des arguments et de la valeur de retour des methodes... Nous vous presentons ici ce 
nouveau type, en vous montrant comment en declarer et en obtenir des instances et comment 
utiliser la methode getName. 

1 .1 Declaration d'instances du type Class 

Avant Java 5, on se contentait de declarer un super-objet de ce type Class de cette maniere : 

Class c ; 

Depuis Java 5, le type Class est devenu generique, de sorte qu'il doit etre parametre : 

• soit par un type explicite, comme dans : 

Class<Point> c ; 

(nous verrons toutefois que cette demarche doit generalement etre evitee) ; 

• soit par un "joker", comme dans : 

Class<?> c ; 

• soit par un "joker avec contraintes", comme dans : 

Class<? extends Point> c ; 

Dans ces trois cas, des contraintes peseront sur la nature des super-objets qu'on pourra affec- 
ter a c (uniquement des classes Point dans le premier cas, n'importe quelle classe dans le 
deuxieme cas, une classe Point ou derivee dans le dernier cas). 



1 .2 Le champ class et La methode getClass 

Pour pouvoir affecter des valeurs a une variable telle que c, il nous faut disposer de super- 
objets de type Class. Pour cela, nous disposons de deux possiblites. 

D'une part, nous pouvons exploiter le fait que toute classe T dispose d'un champ statique 
public, nomme class, fournissant le "super-objet" de type Class correspondant a cette classe 
T. Ainsi, supposons que nous ayons declare : 

Class c<?> ; // ou, avant Java 5 : Class c ; 

La declaration : 

c = Point. class ; 

affecte a c le super-objet representant la classe Point. 



1 - Les bases de I'introspection : le type Class 




D' autre part, toute classe dispose d'une methode getClass qui permet de retrouver la classe 
d'une instance donnee. Ainsi, avec : 

Point p ; 

c = p. getClass () ; 
on affecte a c, ce meme super-objet representant la classe Point. 

Bien entendu ici, 1' utilisation d'une variable telle que c ne semble pas justifiee, dans la 
mesure ou nous savons qu'elle represente toujours le type Point. Mais, il n'en irait plus de 
meme dans une simple situation telle que la suivante ou Ton suppose que Pointcol derive de 
Point : 

Point p ; Pointcol pc ; 
Class c<?> c ; 

if ( ) c = Point. class ; 



// ici c peut representer la classe Point ou la classe Pointcol 

D'une maniere generale, I'introspection pourra etre utilisee dans des circonstances oil exis- 
tent des incertitudes sur la nature de la classe d'un objet. On notera bien qu'il n'existe qu'un 
seul super-objet de type Class pour chaque type classe, de sorte qu'il est possible de se baser 
sur des comparaisons d'egalite telles que : 

if (p. getclass () == Point. class) 
pour savoir si un objet donne est bien une instance d'une classe donnee. 



Compte tenu de F aspect generique du type Class, une declaration telle que : 

Class c ; 

fait l'objet d'un avertissement de compilation (depuis Java 5). Si Ton accepte cet aver- 
tissement, les affectations telles que c = p.getClass() ou c = Point. class restent accep- 
tees. En revanche, si Ton souhaite declarer correctement c sous forme generique, on ne 
pourra generalement pas utiliser des declarations explicites de la forme : 

Class <Point> c; 

En effet, dans ce cas, une simple situation telle que : 

Point p ; 

c = p . getClass ( ) ; 

posera probleme, dans la mesure ou le resultat fourni par getClass est, non pas de type 
Class<Point>, mais de type Class <? extends Point> (revoyez eventuellement le para- 
graphs 6.2 du chapitre 21concernant la programmation generique). En revanche, aucun 
probleme de ce type n'apparaitra si c est declare de type Class < ? extends Point> ou de 
type Class < ?>. 



else 



c = Pointcol . class ; 



Remarque 
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1 .3 La methode getName 

La classe Class dispose d'une methode nommee getName fournissant le nom (String) d'un 
super-objet, done d'une classe. Avec notre precedent exemple : 

Class <?> c ; Point p ; 

c = p.getClass () ; 
l'expression c.getNamef) aurait comme valeur, la chaine "Point". 

Remarques 

1 Comme toute classe, Class dispose d'une methode toString ; celle-ci fournit le meme 
resultat que getName, mais precede du mot "Class". Ces deux instructions fournissent des 
resultats voisins, mais non identiques : 

System. out. println (c. getName () ) ; // affiche : Point 

System. out. println (c) ; // affiche : Class Point 

2 Rappelons que, dans le cas de classes generiques, il y a effacement du parametre de 
type, lors de la compilation. Ainsi, si Ton a defini une classe generique Couple<T> et 
que Ton declare ces variables cp et cj de cette maniere : 

Couple<Point> cp = new Couple<Point> () ; 
Couple <?> cj = new Couple<Point> () ; 

les expressions cp.getClass().getName() et cj.getClass().getName() auront toujours 
comme valeur la chaine "Couple". 

1 .4 Exemple de programme 

Voici un petit programme d'ecole illustrant les differentes possibilites que nous venons 
d'evoquer : 

public class ClasseClass 
{ public static void main (String args[ ] ) 
{ Point p = new Point ( ) ; 

Class<?> c = p.getClass () ; // ou c = Point. class ; 
System. out. println ("classe de c = " + c.getNameO) ; 

// affichage de la conversion de c en String (methode toString) 
System. out. println ("classe de c (obtenue par toString) = " + c) ; 

Couple<Point> cp = new Couple<Point> () ; 
Couple <?> cj = new Couple<Point> () ; 

System. out. println ("classe Couple<Point> = " + cp.getClass () .getName () ) ; 
System. out. println ("classe Couple<?> = " + cj .getClass () .getName () ) ; 

} 

) 
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class Point 

{ private int x, y ; 

} 

class Couple<T> 
{ private T x, y ; 
} 

classe de c = Point 

classe de c (obtenue par toString) = class Point 
classe Couple<Point> = Couple 
classe Couple<?> = Couple 

Utilisation de Class et getClass 




Informations complementaires 



D'une maniere generate, on parle d' introspection lorsqu'il existe des mecanismes permet- 
tant d'obtenir des informations sur une classe ou un objet, pendant F execution du code 1 , 
sans recourrir aux fichiers sources ou au compilateur. Bien entendu, pour que de telles 
possibilites existent, il est necessaire que les informations appropriees figurent (dans le 
cas de Java) dans les bytes codes (fichiers .class). En fait, ces informations sont deja 
exploiters par la machine virtuelle pour detecter les erreurs et afficher leurs causes. H 
existe d'ailleurs un programme utilitaire nomme javap, livre avec le JDK, qui est capable 
d' analyser une classe en affichant toutes les informations d' introspection : il se lance en 
ligne de commande, en faisant simplement suivre son nom du fichier .class correspondant 
(sans l'extension .class). 

2 Acces aux informations relatives a une 
classe 

2.1 Generalit.es : les types Field, Method et Constructor 

Maintenant que nous savons comment obtenir le "super-objet" correspondant a la classe d'un 
objet, voyons comment nous pouvons en extraire des informations, a l'aide des methodes du 
type Class (definies dans le package Java.lang. reflect). Elles vont nous permettre de connai- 
tre notamment les champs (nom, type, statut...) et les methodes (nom, type des arguments et 
de la valeur de retour, statut...). 



1. Voire en analysant des fichiers .class 
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D'une maniere generale, ces methodes utilisent : 

• des objets de type Field pour representer un champ, 

• des objets de type Method pour representer une methode (constructeurs non compris), 

• des objets de type generique Constructor <T> (Constructor avant le JDK 5) pour represen- 
ter un constructeur. 

Par exemple, la methode getDeclaredFields fournit un tableau d'objets de type Field corres- 
pondant aux champs declares, c'est-a-dire effectivement presents dans la definition de la 
classe (ce qui exclut les champs eventuellement herites). Elle s'emploie ainsi : 

Field ] champs = c . getDeclaredFields ( ) ; 
La methode GetFields fournirait tous les champs publics, mais y compris cette fois ceux 
herites. 

De la meme maniere, la methode getDeclaredMethods fournit un tableau d'objets de type 
Method, correspondant aux methodes declarees (sans les constructeurs) : 

Method ] methodesd = c . getDeclaredMethods ( ) ; 
La methode getMethods founirait toutes les methodes publiques, y compris celles heritees. 

Enfin, la methode getDeclaredConstructors fournit un tableau d'objets de type Constructor, 
correspondant aux constructeurs declares (attention, le type Constructor est generique depuis 
Java 5) : 

Constructor <? >[ ] constructeurs = c . getDeclaredConstructors ( ) ; 

La methode getConstructors fournirait seulement les constructeurs publics. 

2.2 Exemple d'acces aux noms de champs et methodes 

Comme on peut s'y attendre, chacune des classes Field, Method et Constructor dispose, entre 
autres, d'une methode getName fournissant le nom de champ ou de methode correspondant. 

Voici un premier exemple de programme exploitant ces possibilites d' analyse des compo- 
sants d'une classe, dans lequel nous affichons les noms des champs, des constructeurs et des 
methodes : 

import java.lang. reflect.* ; // pour les methodes de Class 
public class MethodesClassl 
{ public static void main (String args[ ] ) 
{ Point p = new Point ( ) ; 
Class<?> c = p.getClass() ; 

Field] champs = c . getDeclaredFields ( ) ; 
System. out. println (" Champs de Point :") ; 

for (Field champ : champs) System. out. print (champ. getName () + " ") ; 
System. out. println () ; 

Method ] methodes = c . getMethods ( ) ; 

System. out. println (" Noms de toutes les methodes de Point :") ; 
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for (Method methode : methodes) System. out. print (methode . getName ( ) + " ") ; 
System . out . println ( ) ; 

Method! ] methodesd = c . getDeclaredMethods ( ) ; 

System. out. println (" Noms des methodes declarees de Point :") ; 

for (Method methoded : methodesd) System. out. print (methoded. getName () + " ") ; 
System. out. println () ; 

Constructor <?>[ ] constructeurs = c . getDeclaredConstructors ( ) ; 

System. out. println (" Constructeurs de Point :") ; 

for (Constructor^ > constructeur : constructeurs) 
System . out .println ( constructeur . getName ( ) ) ; 

} 

} 

class Point 

{ public Point () { x=0 ; y=0 ; compte++ ;} 

public Point (int x, int y) {this.x = x ; this.y = y ; compte++ ;} 
public void deplace (int dx, int dy) { x+=dx ; y+= dy ; } 
private void symetrise ( ) { x = -x ; y= -y ; } 
public static void afficheNbre () 

{ System. out. println ("il y a "+compte+ "points") ; } 
private int x, y ; 
public static int compte=0 ; 

} 

Champs de Point : 

x y compte 

Noms de toutes les methodes de Point : 

deplace afficheNbre hashCode getClass wait wait wait equals toString notify notifyAll 

Noms des methodes declarees de Point : 

deplace symetrise afficheNbre 

Constructeurs de Point : 

Point 
Point 

Acces aux noms de champs et de methodes 

Remarque 

On pourrait s'affranchir de declarer une variable c, en utilisant directement des instruc- 
tions de la forme : 

Field] champs = Point, class. getDeclaredFields () ; 
ou encore : 

Field ] champs = p. getClass () .getDeclaredFields () ; 
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2.3 



Acces aux autres informations 



2.3.1 Des champs 



Dans la classe Field, on trouve, en plus de getName, un certain nombre de methodes permet- 
tant d'obtenir des informations sur le champ concerne. Notamment : 

• la methode getType fournit le type du champ, sous forme d'un objet de type Class<?> ; on 
notera que les types de base disposent eux-aussi d'un tel type, par exemple Class<int> ou 
Class<double> (attention, la methode getClass fournirait comme resultat la classe Field) ; 

• la methode getModifiers fournit un entier dont la valeur depend des modificateurs {public, 
private, protected, static.) ; 

• la classe Modifier propose des methodes (isPublic, isPrivate, isStatic.) permettant de sa- 
voir si un modificateur donne est present dans l'entier precedent. 

Voici un exemple d' utilisation de ces methodes : 

import j ava . lang . reflect . * ; 
public class MethodesClass2 
{ public static void main (String args[ ] ) 
{ Point p = new Point ( ) ; 

Class<?> c = p. getClass () ; 

Field champs[ ] = c . getDeclaredFields ( ) ; 



// affichage des informations relatives aux champs de la classe de p 
for (Field champ : champs) 

{ System. out. println (" Champ de nom : " + champ . getName () ) ; 

System. out. println ("type : " + champ. getType (). getName () ) ; 

int mod = champ . getModifiers ( ) ; 

System. out. println ("modificateurs : " + mod) ; 

if (Modifier . isPrivate (mod) ) System. out .println ("prive") ; 

if (Modifier. isStatic (mod) ) System. out .println ("static") ; 



} 

} 

class Point 

{ public Point () { x=0 ; y=0 ; compte+t ;} 

public Point (int x, int y) {this.x = x ; this.y = y ; compte++ ;) 
public void deplace (int dx, int dy) { x+=dx ; y+= dy ; } 
private void symetrise ( ) { x = -x ; y= -y ; } 
public static void afficheNbre () 

{ System. out. println ("il y a "+compte+ "points") ; } 
private int x, y ; 
public static int compte=0 ; 
protected int z ; 

} 

Champ de nom : x 

type : int 
modificateurs : 2 
prive 
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Champ de nom : y 

type : int 

modif icateurs : 2 

prive 

Champ de nom : compte 

type : int 

modif icateurs : 9 

static 

Champ de nom : z 

type : int 

modif icateurs : 4 



Acces aux differentes informations relatives aux champs d'une classe 



La methode toString de la classe Field fournit une chaine contenant F ensemble des infor- 
mations relatives au champ correspondant. Celles-ci ne sont pas faciles a exploiter ainsi, 
mais si le but est simplement de les afficher, on peut alors se contenter d' instructions du 



System. out. println ("informations sur le champ c" + c) ; 

Par exemple, si Ton introduit ces instructions dans le programme precedent : 

System . out . println (" Champs declares de Point (par toString : )") ; 

for (Field champ : champs) System. out. println (champ) ; 

on obtiendra les resultats suivants : 

Champs declares de Point (par toString) : 

private int Point. x 
private int Point. y 



2.3.2 Des methodes 

Dans les classes Method et Construtor, on trouve, en plus de getName, un certain nombre de 
methodes permettant d'obtenir des informations sur la methode concernee. Notamment : 

• la methode getModifiers fournit un entier dont la valeur depend des modificateurs {public, 
private, protected, static, synchronized, final...) ; 

• la classe Modifier propose des methodes (isPublic, isPrivate, isStatic.) permettant de sa- 
voir si un modificateur donne est present dans l'entier precedent ; 

• la methode getReturnType fournit un objet de type Class<?> correspondant au type de la 
valeur de retour (bien entendu, cette methode n'existe pas dans la classe Constructor) ; 

• la methode getParameterTypes fournit un tableau d' objet de type Class<?> correspondant 
aux types des differents arguments ; 

• la methode getExceptionType fournit un tableau d' elements de type Class <?> correspon- 
dant aux types des exceptions levees par la methode. 




Remarque 



genre : 
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Voici un exemple d' utilisation de ces methodes : 

import java.lang. reflect.* ; 
public class MethodesClass3 

{ public static void main (String args[ ] ) throws IllegalAccessException 
{ Point p = new Point ( ) ; 
Class<?> c = p.getClass() ; 
Method methodes[ ] = c . getDeclaredMethods ( ) ; 

// affichage des informations relatives aux methodes de la classe de p 
for (Method methode : methodes) 

{ System. out. println (" Methode de nom : " + methode . getName () ) ; 

System. out. print ("- type arguments : ") ; 

Class<?> typeArgs [] = methode . getParameterTypes ( ) ; 

for (Class<?> typeArg : typeArgs ) 

{ System. out. print (typeArg. getName () + " ") ; 

} 

System. out. println () ; 

Class<?> typeRetour = methode . getReturnType ( ) ; 

System. out. println ("- type valeur de retour : " + typeRetour . getName () ) ; 
System. out. println ("- modif icateurs : " + methode. getModif iers () ) ; 

} 

// affichage des informations relatives aux constructeurs de la classe de p 
Constructor^? > constructeurs [] = c.getDeclaredConstructors () ; 
for (Constructor<?> constructeur : constructeurs) 

{ System. out. println (" Constructeur de nom : " + constructeur . getName () ) ; 

System. out. print ("- type arguments : ") ; 

Class<?> typeArgs [] = constructeur .getParameterTypes () ; 

for (Class<?> typeArg : typeArgs ) 

{ System. out. print (typeArg. getName () + " ") ; 

} 

System. out. println () ; 

System. out. println ("- modificateurs : " + constructeur. getModif iers () ) ; 

} 

} 

} 

class Point 

{ public Point () { x=0 ; y=0 ; compte+t ;} 

public Point (int x, int y) {this.x = x ; this.y = y ; compte+t ;} 
protected void deplace (int dx, int dy) { x+=dx ; y+= dy ; } 
private void symetrise ( ) ( x = -x ; y= -y ; } 
public static void afficheNbre () 

{ System. out. println ("il y a "+compte+ "points") ; } 
private int x, y ; 
public static int compte=0 ; 

} 

Methode de nom : deplace 

- type arguments : int int 

- type valeur de retour : void 

- modificateurs : 4 
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Methode de nom : symetrise 

- type arguments : 

- type valeur de retour : void 

- modificateurs : 2 

Methode de nom : afficheNbre 

- type arguments : 

- type valeur de retour : void 

- modificateurs : 9 

Constructeur de nom : Point 

- type arguments : 

- modificateurs : 1 

Constructeur de nom : Point 

- type arguments : int int 

- modificateurs : 1 

Acces aux differentes informations relatives aux methodes d'une classe 



La methode toString des classes Method et Constructor fournit une chame contenant 
l'ensemble des informations relatives au champ ou a la methode correspondante. Celles- 
ci ne sont pas faciles a exploiter ainsi, mais si le but est simplement de les afficher, on 
peut alors se contenter d' instructions telles que : 

System. out. println ("informations sur la methode m" + m) ; 

Par exemple, si Ton introduit ces instructions dans le programme precedent : 

System. out. println (" Methodes declarees de Point (obtenues par toString) :") ; 

for (Method methoded : methodesd) System . out . println (methoded) ; 

System. out. println (" Constructeurs declares de Point (obtenus par toString) :") ; 

for ( Constructor^ > constructeur : constructeurs ) System. out. println (constructeur) ; 

on obtiendra les resultats suivants : 

Methodes declarees de Point (obtenues par toString) : 

public void Point. deplace (int, int) 

private void Point. symetrise () 

public static void Point. af f icheNbre () 

Constructeurs declares de Point (obtenus par toString) : 

public Point ( ) 
public Point (int, int) 



2.3.3 Test d'appartenance 

On peut egalement examiner la presence d'un champ, d'une methode ou d'un constructeur, a 
l'aide de methodes voisines des precedentes : 

getDeclaredMethod, getMethod, getDeclaredField, getField, getContructor, 
getDeclaredConstructor. 




Remarque 
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On leur fournit, en argument le nom du champ ou de la methode cherchee, ainsi que le type 
des arguments (pour les methodes et les constructeurs) ; on obtient en resultat Fobjet 
correspondant {Field, Method ou Constructor). En revanche, si aucun element de ce nom 
n'est trouve dans la classe, on obtient une exception de type NoSuchFieldException, 
NoSuchMethodException ou NoSuchConstructorException, suivant le cas. 

Par exemple, avec : 

Method md = Point. class. getDeclaredMethodC'deplace", int. class, int. class) ; 
on obtiendra l'objet md correspondant a la methode deplace de la classe Point, dotee de deux 
arguments de type entier. Si cette methode n'existait pas, on obtiendrait une exception de 
type NoSuchMethodException. 

3 Consultation et modification des champs 
d'un objet 

N.B. Ce paragraphe peut etre ignore dans un premier temps. 

Jusqu'ici, nous nous sommes contentes d' exploiter les informations associees a la classe d'un 
objet. Mais l'introspection permet egalement de connaitre les valeurs des champs d'instances 
donnees. Par exemple, si Ton dispose d'objets pi et p2 de type Point (pour l'instant, nous 
supposons toutefois que leurs champs x et y sont publics), il est possible d'acceder a la valeur 
de chacun des champs x et y, et meme de modifier ces valeurs. 

Pour connaitre la valeur d'un champ donne (par exemple, champs[0]) de l'objet pi, on 
pourra utiliser la methode getlnt de la classe Field : 

champst 0] .getlnt (pi) ; // notez qu' on cite bien 1' instance concernee, ici pi 

ce qui nous fournira un resultat de type entier. Bien entendu, il existe de telles methodes pour 
chaque type de base (getlnt, getDouble, getChar...). L'utilisation d'une methode ne corres- 
pondant pas a un type compatible par affectation avec le type effectif du champ provoque une 
exception implicite IllegalArgumentException. De plus, il existe une methode get qui renvoie 
simplement un objet du type du champ, ou du type enveloppe pour les types de base (par 
exemple, Integer pour un ini). 

Par ailleurs, il existe des methodes semblables pour modifier la valeur d'un champ donne 
d'une instance donnee : setlnt, setDouble, setChar... pour des champs d'un type de base, set 
pour un champ de type objet. La encore un type non compatible par affectation provoquera 
une exception implicite. 

A noter que ces methodes de la forme getXXX et setXXX peuvent declencher une exception 
explicite IllegalAccessException, lorsque le champ correspondant n'est pas accessible. 

Voici un petit programme illustrant ces differentes possibilites : 
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import java. lang. reflect.* ; 
public class ModifsChamps 

{ public static void main (String args[ ] (throws IllegalAccessException 
{ Point pi = new Point () ; Point p2= new Point (5, 9) ; 
Class<?> c = pl.getClassO ; 
Field champs!] = c.getDeclaredFields () ; 

// Recuperation des valeurs du premier champ de pi et de p2 
int xpl = champs[ 0] . getlnt(pl) ; // on suppose le type (int) connu 
Object xp2 = champs! 0] .get(p2) ; // on ne suppose pas de type particulier 

//on obtiendra un objet de type Integer 
System. out. println ("type de xp2 = " + xp2 .getClass () .getName () ) ; 
System. out. println ("Pour pi, champ " + champs! 0] .getName () + " = " + xpl) ; 
System. out. println ("Pour p2, champ " + champs! 1] .getName () + " = " + xp2) ; 

// Modification des valeurs du premier champ de pi et de p2 
Integer io = 100 ; 
champs! 0] .set(p2,io) ; 
champs! 1] .setlnt (pi, 999) ; 

System. out. println ("Pour pi, champ " + champs! 0] .getName () 

+ " = " + champs! 0] .getlnt (pi) ) ; 
System. out. println ("Pour p2, champ " + champs! 1] .getName () 

+ " = " + champs! 1] . ge trouble (p2 ) ) ; 
System. out. print ("appel affiche sur pi - ") ; pl.affiche () ; 
System. out. print ("appel affiche sur p2 - ") ; p2. affiche () ; 

} 

} 

class Point 

{ public Point () { x=0; y=0; } 

public Point (int x, int y) { this.x = x ; this.y = y ; } 

void affiche () { System. out. println ("coordonnees : " + x + " " + y) ; ) 

private int x, y ; 

} 

type de xp2 = j ava . lang . Integer 
Pour pi, champ x = 0 
Pour p2, champ y = 5 
Pour pi, champ x = 0 
Pour p2, champ y = 9.0 

appel affiche sur pi - coordonnees : 0 999 
appel affiche sur p2 - coordonnees : 100 9 

Consultation et modification de valeurs de champs par introspection 




Informations complementaires 



Jusqu'ici, nous n'avons pas vraiment viole le principe d' encapsulation puisque nous nous 
sommes contentes de modifier les valeurs de champs publics. Mais, il est malheureuse- 
ment possible de faire de meme sur des champs prives. II suffit pour cela de les "rendre 
accessibles" en utilisant la methode setAccessible de la classe Field. Par exemple, si x et y 
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avaient ete prives dans notre precedent programme, il nous aurait suffit d'ajouter ces deux 
instructions : 

champs[ 0] . setAccessible (true) ; champs[ 1] .setAccessible(true) ; 

Par ailleurs, de meme qu'on peut dynamiquement modifier un champ d'un objet, on 
peut lancer dynamiquement une methode sur un objet, a l'aide de la methode invoke de 
la classe Method. 

4 La notion d'annotation 

N.B. Les annotations ont ete introduites par Java 5 et elles ont ete pleinement integrees dans 
le langage par Java 6. 

Une annotation peut etre considered comme une "marque" 1 , eventuellement assortie de para- 
metres, qu'on peut attribuer a une classe, une methode, un champ..., lors de leur definition 
(dans le code source). 

II existe quelques "annotations standards" qui pourront etre exploiters par le compilateur lui- 
meme. Mais la puissance des annotations vient surtout de la possibilite pour l'utilisateur de 
definir ses propres annotations qui pourront ensuite etre exploiters : 

• pendant 1' execution du code lui-meme, notamment grace aux possibilites d' introspection 
qui, depuis Java 5, ont ete etendues aux annotations ; 

• par d'autres outils qui viendront exploiter soit les fichiers sources (Java), soit les fichiers de 
byte codes (.class) ; ces possibilites sont actuellement largement utilisees dans les specifi- 
cations JEE, par exemple avec les EJB ou avec JDBC... 

Nous commencerons par voir, sur un exemple simple, comment definir, puis utiliser une 
annotation. Nous examinerons la facon de les parametrer et de leur attribuer certaines pro- 
prietes (elements auxquels elles sont applicables, duree de vie, heritage eventuel...) a l'aide 
de "meta-annotations" (annotations s'appliquant a des annotations). 

4.1 Exemple simple d'annotation 

Voyons comment definir et utiliser une annotation simple (ne comportant pas de parametres) 
qui sera done simplement caracterisee par le nom que nous lui donnerons, ici Marque. Sa 
definition se presentera comme ceci : 

public Sinterface Marque 
{ } 

Elle ressemble a celle d'une interface (en utilisant le terme ©interface au lieu de interface), 
avec un statut (public, private, protected ou rien), un nom et un corps (ici vide). 



1. On parle parfois de meta-donnees pour qualifier ces donnees qui viennent s'ajouter au code lui-meme, sans 
en changer la signification. 
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Cette annotation pourra alors etre appliquee, entre autres 1 , a une classe, une methode ou a un 
champ. Dans tous les cas, elle s'utilise en placant son nom, precede de @ (ici ©Marque) au 
meme niveau qu'un modificateur (comme public ou static). Bien que ce ne soit pas une 
necessite, il est d' usage de placer F annotation avant les autres modificateurs sur une ligne 
separee. En voici des exemples : 

@Marque 

public class A // Ici, la classe A est annotee avec Marque 

{ } 

class A 

{ int f () { } 

@Marque 

void g() { } // Ici, la methode g est annotee avec Marque 

@Marque 

public static int compte ; // Ici, le champ compte est annote avec Marque 

} 



4.2 Les parametres d'une annotation 
4.2.1 Presentation 

L' annotation de l'exemple precedent etait tres simple car reduite a une simple marque. Mais 
une annotation peut disposer de un ou plusieurs parametres (appeles aussi "attributs"). Voyez 
cet exemple : 

public @ interface Informations 
{ String message () ; 
int annee () ; 

} 

Ici, notre annotation Informations dispose de deux parametres nommes message (de type 
String) et annee (de type int). Notez la syntaxe particuliere de la definition des parametres qui 
impose des parentheses : les declarations de parametres se presentent comme des decla- 
rations de methodes sans arguments. 

Notez que le seul modificateur autorise pour les declarations de parametres est public et qu'il 
peut etre omis. 

La encore, cette annotation pourra etre appliquee (entre autres) a une classe, un champ ou une 
methode. II suffira de lui fournir les valeurs des parametres requis de cette maniere : 

@Informations (message = "code provisoire", annee = 2007) 
public class A 
{ } 

Notez qu'il n'est pas necessaire de respecter l'ordre des parametres tel qu'il figure dans la 
definition de 1' annotation. Cette ecriture serait encore correcte : 

(^Informations (annee = 2007, message = "code provisoire") 



1. Nous verrons plus tard l'ensemble des possibilites. 
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4.2.2 Parametres par defaut 

Lors de la definition d'une annotation, on peut foumir des valeurs par defaut pour tout ou 
partie des parametres, comme dans : 

public Sinterface Informations 

{ String message () default "" ; // message vide par defaut 
int annee () ; // pas de valeur par defaut 

} 

Dans ce cas, lors de l'utilisation de l'annotation, il est possible de ne pas foumir de valeur 
pour les parametres disposant d'une valeur par defaut. Par exemple : 

(•(Informations (annee = 2005) 

est equivalent a : 

{(Informations (message = "", annee = 2005) 

4.2.3 Cas particulier du parametre nomme value 

Le nom de parametre value joue un role particulier. Si une annotation possede un tel parame- 
tre, son nom peut etre omis devant la valeur du parametre dans l'utilisation de l'annotation, a 
condition qu'il soit le seul parametre mentionne. Par exemple, avec cette definition : 

public ((interface Quantite 
{ int value default 10 ; 
} 

l'annotation: 

@Quantite (15) 

est equivalente a : 

@Quantite (value = 15) . 

En general, pour des questions de lisibilite, cette possibility est plutot reservee a des annota- 
tions a un seul parametre. Toutefois, avec cette definition : 

public ((interface Annot 
{ String message () default " " ; 
int value () ; 

} 

l'annotation 

@Annot (10) 

est equivalente a : 

@Annot (value = 10) 

ou encore, a : 

@Annot (message = "", value = 10) 
En revanche, cette utilisation sera rejetee : 

@Annot (message = "", 10) 
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4.2.4 Un parametre peut etre un tableau 

Nous verrons plus loin les differents types autorises pour les parametres d'une annotation. 
Pour Finstant, sachez qu'il est possible de prevoir un tableau comme parametre. Par exemple, 
cette definition d' annotation sera correcte : 

@interface Valeurs 

{ int[ ] value () ; // value est un tableau 3 entiers 
} 

On l'utilisera en fournissant un tableau de valeurs, en employant la notation utilisee pour les 
initialisations de tableaux lors d'une declaration. En voici un exemple : 

gvaleurs ({ 2, 9, 12, 0} ) 
class A { } 

Si Ton ne fournit qu'une seule valeur, on peut omettre les accolades : 

gvaleurs (12) 
class A | } 

II n'est pas possible de fournir un tableau vide. 

5 Les meta-annotations standards 

II est possible d'annoter une annotation lors de sa definition. On parle alors de meta-annota- 
tions. II existe quelques meta-annotations predefinies (elles figurent dans java.lang. annota- 
tion) qui, a une exception pres, possedent une signification precise pour le compilateur. 

5.1 La meta-annotation ©Retention 

Jusqu'ici, nous ne nous sommes pas preocupes de ce que devenaient les annotations mar- 
quant une entite (classe, champ, methode...). Pour ce faire, il faut bien distinguer les fichiers 
sources (Java) des fichiers de bytes codes obtenus apres compilation (.class). Ce sont ces 
derniers qui sont exploites par la "machine virtuelle Java", laquelle n'est rien d'autre qu'un 
interpreteur de bytes codes. 

En fait, lorsqu'on definit une annotation, il est possible d'influer sur sa "duree de vie", en 
l'annotant avec la meta-annotation ©Retention, a laquelle on fournira un parametre (son 
nom est value, il peut done etre omis) dont la valeur sera choisie parmi l'une des trois 
suivantes : 
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Valeur de ©Retention 


Signification 


RetentionPolicy.SOURCE 


L'annotation ne sera conservee que dans les fichiers sources. El le 
ne pourra done plus etre exploitee lors de I'execution (par intros- 
pection, notamment). Elle restera toutefois exploitable par des outils 
d'analyse de fichiers souces. 


Retention roi icy. L/LAbo 


L'annotation sera conservee dans les fichiers .class, (en plus des 
fichiers sources) mais ne sera pas accessible a la machine virtuelle. 
L'instrospection ne sera pas possible. L'annotation pourra cepen- 
dant etre exploitee par des outils qui travaillent directement sur des 
fichiers .class. 

II s'agit de la duree de vie par defaut (e'est-a-dire lorsque aucune 
meta-annotation ©Retention ne figure devant la definition de 
l'annotation. 


RetentionPolicy.RUNTIME 


L'annotation sera conservee dans les fichiers .class, (en plus des 
fichiers sources) et sera accessible a la machine virtuelle. L'instros- 
pection sera possible. 



Role du parametre foumi a ©Retention 



Notez que ces trois valeurs sont des constantes d'une enumeration nominee RetentionPolicy, 
definie dans java.lang.enumeration. 

En voici un exemple : 

import java.lang. annotation.* ; // pour le type RententionPolicy 



@Retention (RetentionPolicy . RUNTIME ) 

public Sinterface AnnotA // @AnnotA sera accesible a la machine virtuelle 

{ } 

Remarque 

On notera bien que le choix de la duree de vie d'une annotation s'opere lors de sa 
definition et, en aucun cas, au moment de son utilisation. 



5.2 La meta-annotation @ Target 

Lors de la definition d'une annotation, il est possible de preciser a quelles entites il sera pos- 
sible de l'appliquer. Pour ce faire, on emploie la meta-annotation ©Target qui dispose d'un 
parametre de nom value, lequel represents un tableau de valeurs choisies parmi les 
suivantes : 
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Valeur 


Element auquel I'annotation pourra s'appliquer 


ElementType.ANNOTATION_TYPE 


annotations 


ElementType.CONSTRUCTOR 


constructeurs 


ElementType. FIELD 


champs 


ElementType.LOCALJ/ARIABLE 


variables locales 


ElementType.METHOD 


methodes 


ElementType.PACKAGE 


package 


ElementType. PARAMETER 


parametres d'une methode ou d'un constructeur 


ElementType.TYPE 


declarations de type (class, inteface ou enumeration) 



Notez que ces differentes valeurs sont en fait des constantes d'une enumeration nommee 
ElementType, definie dans java.lang.enume ration. 

En voici un exemple : 

import java.lang. annotation.* ; // pour le type ElementType 



@Target ({ ElementType. CLASS, ElementType.METHOD, ElementType . FIELD} ) 
public @ interface AnnotB 
{ } 

Ici, notre annotation AnnotB pourra s'appliquer a des classes, des methodes ou des champs. 
Par defaut, une annotation s' applique a tous les elements mentionnes ci-dessus. 



5.3 La meta-annotation ©Inherit 

Supposons que nous avons defini une annotation nommee @AnnotC. Considerons alors cette 
situation : 

public @ interface AnnotC 

{ } // definition d une annotation SAnnotC 

@AnnotC (...) //la classe A est annotee avec @AnnotC 

class A ( } 

class B extends A { } //la classe B ne 1' est pas 

Bien que derivee de A, la classe B n'est pas consideree comme annotee par ©AnnotC. II 
s'agit la du comportement par defaut des annotations, par rapport a l'heritage. II est cepen- 
dant possible de prevoir, lors de sa definition, qu'une annotation sera heritee. II suffit d'utili- 
ser la meta-annotation ©Inherit, comme dans cet exemple : 
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@ Inherit 



public Sinterface AnnotD 



// definition d une annotation SAnnotD marquee avec SInherit 



SAnnotD (...) 
class A { . . . 



// la classe A est annotee avec @AnnotD 



class B extends A { 



} // la classe B 1' est egalement 



L'effet de @Inherit ne concerne que les annotations appliquees a des classes. Mais on peut 
l'introduire dans la definition de n'importe quelle annotation, quels que soient les elements 
auxquels on la destine (©Target) ; simplement, @Ihnerit sera inoperant lorsqu'on l'appli- 
quera a autre chose que des classes. 



Alors que les trois meta-annotations precedentes etaient prises en compte par le compilateur, 
©Documented n'est qu'une sorte de terme standard offert au developpeur pour marquer les 
annotations qu'ils souhaite voir prises en compte dans un outil de documentation automati- 
que de code 1 . Cette meta-annotation est elle-meme marquee par ©Inherited, ce qui signifie 
qu'elle est automatiquement heritee. 



Nous venons de voir comment realiser nos propres annotations. En fait, il existe quelques 
annotations standards que nous allons examiner maintenant (elles ont ete introduites par 
Java 5 et completees par Java 6). 



Considerez cette situation : 

class A 

{ int f (int n) { . . . } 
} 

Supposez qu'on souhaite deriver une classe B de A, en y redefinissant la methode/et qu'on 
procede ainsi : 

class B 

{ float f (int n) { . . . } 
} 



5.4 La meta-annotation ©Documented 



6 Les annotations standards 



6.1 Override 



1 . Comme javadoc, 1* outil standard fourni avec le JDK, qui exploite des commentaires d'une forme particuliere 
et qui prend bien en compte cette meta-annotation @Documented pour intoduire des informations sur ['annota- 
tion concernee. 
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Ici, compte tenu du type de sa valeur de retour, la methode/de la classe B est une surdefini- 
tion de celle de A, et non une redefinition. Mais, aucune erreur ne peut etre signalee par le 
compilateur. 

L' annotation ©Override permet de marquer une methode comme etant une redefinition. 
Ainsi, en declarant notre classe B de cette maniere : 

class B 

{ SOverride //la methode f doit etre une redefinition 
float f (int n) { . . . } 

} 

on obtiendra une erreur de compilation, due a ce que notre nouvelle methode / ne redefinit 
aucune des methodes d'une classe ascendante. 



6.2 @Deprecated 



Cette annotation permet au compilateur d'afficher un message d'avertissement en cas d'utili- 
sation de 1' element annote. 



6.3 @SuppressWarnings 



On lui fournit un tableau de chaines, correspondant chacune a un type d'avertissement qu'on 
souhaite ne pas voir s'afficher pour la compilation de l'element concerne. Les libelles utilises 
peuvent dependre du compilateur utilise. En principe, ce dernier devrait toujours accepter 
ceux prevus par le compilateur en ligne de commande ja vac. 

On peut imbriquer ces annotations (par exemple une methode annotee dans une classe elle- 
meme annotee). Un element donne se voit concerne par sa propre annotation et par les anno- 
tations englobantes. 
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Cette annotation a ete introduite par Java 6 pour signaler du code genere automatiquement. 
Elle possede trois parametres de type String, nommes value, comments et date. Generalement 
le premier parametre sert a identifier la classe ayant genere le code. 

Informations complementaires 

Beaucoup d'autres annotations standards ont ete introduites par Java 6, essentiellement 
pour normaliser l'utilisation des API specifiees par JEE, notamment les EJB ou les Ser- 
vlets. A simple titre indicatif, sachez qu'elles se nomment : @Ressource, @PostCons- 
truct, @PreDestroy, @DeclaredRoles, @ Roles Allowed, @PermitAll et @DenyAll. 
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7 Syntaxe generate des annotations 

Voici un recapitulatif de la syntaxe generale de la definition d'une annotation : 

Modificateurs ©interface NomAnnotation 
{ type_1 parametre_1 ()[ default valeuM] ; 
type_2 parametre_2 () [ default valeur_2] ; 



} 

Definition d'une annotation 

• Modificateurs : public, private, protected ou rien 

• type_i : 

- type primitif, 

- String, 

- enumeration, 

- type d' annotation, 

- Class <?> ou Class <? extends T> (Class<T> est syntaxiquement permis, mais de- 
conseille), 

- un tableau de Fun des types precedents (les tableaux de tableaux sont interdits). 

• valeurj. : expression constante d'un type compatible avec type_i ; la valeur null est interdite 
(on peut utiliser a la place void.class) ; 



Voici un exemple d'ecole (sans signification particuliere) illustant les differents elements 
qu'on peut trouver dans la definition d'une anotation : 

(•■interface Information 
{ String message () ; 
int annee () ; 

} 

@Retention (RetentionPolicy .RUNTIME) 
Sinterface MonAnnotation 

{ enum Etat { A_JOUR, A_ACTUALISER, PERIME } ; // definition d' une enumeration 
Etat etat() default Etat.A_JOUR ; 

Class <? extends Debug> mise_au_point () default Debug. class ; 

Class <? extends Object> type() ; 

int[ ] seguence () default {3, 9, 7, 15 } ; 

Information infos () ; 
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8 Exploitation des annotations 
par introspection 

Depuis Java 5, les classes Class, Field, Method et Constructor ont ete dotees de methodes 
permettant d'obtenir des informations sur les annotations presentes sur les elements corres- 
pondants. On notera que pour que F introspection fonctionne sur une annotation, il est neces- 
saire que celle-ci ait ete definie avec la valeur RetentionPolicy.RUNTIME de la meta- 
annotation ©Retention. 

8.1 Test de presence et recuperation des parametres 

La plupart du temps, le besoin d'instrospection se bornera a savoir si une annotation est pre- 
sente sur un element donne et, le cas echeant, a en recuperer les parametres. 

Pour ce faire, nous utiliserons les methodes suivantes des classes Class, Field et Method : 

• isAnnotationPresent qui teste si une annotation donnee (consideree comme une classe) four- 
nie en argument est presente, par exemple : 

if (A. class. isAnnotationPresent (Infos. class) ) 

examine si F annotation @ Infos (classe de nom Infos) est presente sur la classe A ; 

• getAnnotation qui recoit en argument la classe de F annotation recherchee et qui fournit en 
resultat un objet du type de F annotation en question ; par exemple, si ml est un objet de type 
Method, avec : 

Infos ainfl = ml .getAnnotation (Infos . class) ; 

on obtient Fobjet ainfl, de type Infos correspondant a Fannotation @Infos presente sur la 
methode ml. Quant a la valeur des eventuels parametres, elle s'obtiendra simplement en uti- 
lisant des expressions de la forme ainfl.param() (param designant le nom d'un parametre 
de Fannotation ainfl). 

Voici un programme dans lequel nous definissons une annotation nommee @Infos, avec deux 
parametres nommes message et value, que nous utilisons pour annoter certains elements de 
deux classes A et B. Apres s'etre assure de la presence de Fannotation sur ces differents ele- 
ments, on recupere la valeur des deux parametres. 

import java.lang. annotation.* ; 
import java.lang. reflect.* ; 
public class IntroAnnot 

{ public static void main (String args[ ] ) throws NoSuchMethodException 
{ if (A. class . isAnnotationPresent (Infos . class) ) 

System. out. println (" — @ Infos presente sur A") ; 
else System. out. println (" — @Infos non presente sur A") ; 
if (B. class. isAnnotationPresent (Infos .class) ) 

System. out. println (" — @Infos presente sur B") ; 
else System. out. println (" — @Infos non presente sur B") ; 
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Method ml = A.class.getDeclaredMethodC'f") ; 
if (ml . isAnnotationPresent ( Infos . class ) ) 
{ System. out. println (" — @Infos presente sur A.f") ; 

Infos ainfl = ml . getAnnotation (Infos .class) ; 

System. out. println ("message = " + ainfl .message () ) ; 

System. out. println ("value = " + ainfl .value () ) ; 

} 

Method m2 = A.class.getDeclaredMethodC'g") ; 
if (m2 . isAnnotationPresent ( Infos . class ) ) 
{ System. out. println (" — @Infos presente sur A.g") ; 

Infos ainf2 = m2 .getAnnotation (Infos .class) ; 

System. out. println ("message = " + ainf2 .message () ) ; 

System. out. println ("value = " + ainf2 .value () ) ; 




} 

@Infos (message = "Message Classe A", value = 20) 
class A 

{ @Infos (message = "Message methode f") 
void f () {} 
@Infos (12) 
void g() {} 
void h() {} 

} 

class B { ) 
@Retention (RetentionPolicy . RUNTIME) 
@interface Infos 

{ String message)) default "Rien" ; 
int value () default 0 ; 

} 

— @ Infos presente sur A 

— @ Infos non presente sur B 

— @ Infos presente sur A.f 
message = Message methode f 
value = 0 

— @ Infos presente sur A.g 
message = Rien 

value = 12 



Recuperation des parametres d'une annotation sur une classe ou une methode 
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Remarque 

On notera bien qu'une expression telle que Infos.messagef) n'aurait pas de sens. Les 
valeurs des parametres d'une annotation sont attaches, non pas a un type annotation 
{Infos), mais a une instance de ce type (telle que ainfl). 

8.2 Obtenir toutes les annotations presentes sur un element 

Bien que cela soit d'un usage peu frequent, il est possible d' obtenir l'ensemble des annota- 
tions presentes sur un element donne. Pour ce faire, il existe un type Annotation dont les ins- 
tances sont des types d' annotation. Ce type dispose d'une methode AnnotationType qui 
fournit la classe correspondante. Les classes Class, Field, Method et Constructor disposent 
des methode s : 

• getAnnotations qui fournit un tableau d'objets de type Annotation correspondant aux anno- 
tations de l'element concerne, y compris celles heritees, 

• getDeclaredAnnotations qui fournit les annotations effectivement declarees. 
Voici un exemple : 

import java.lang. annotation.* ; 
import java.lang. reflect.* ; 
public class IntroAnnot2 

{ public static void main (String args[ ] ) throws NoSuchMethodException 
{ Annotationf] annotationsDeA = A. class. getAnnotations () ; 
System. out. println ("Annotations de la classe A : ") ; 
for (Annotation a : annotationsDeA) 

System. out. println (a.annotationType () .getName () ) ; 

Method ml = A.class.getDeclaredMethod("f") ; 
Annotationf ] annotationsDEf = ml . getAnnotations ( ) ; 
System. out. println ("Annotations de la methode A.f : ") ; 
for (Annotation a : annotationsDEf) 

System. out. println (a.annotationType () .getName () ) ; 

Annotationf] annotationsDeB = B. class. getAnnotations () ; 
System. out. println ("Annotations de la classe B : ") ; 
for (Annotation a : annotationsDeB) 

System. out. println (a.annotationType () .getName () ) ; 
Annotationf] annotationsDeclDeB = B. class. getDeclaredAnnotations () ; 
System. out. println ("Annotations declarees de la classe B : "); 
for (Annotation a : annotationsDeclDeB) 

System. out. println (a.annotationType () .getName () ) ; 
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@ Deprecated 

@Infos (message = "Message Classe A", value = 20) 

class A 

{ @Deprecated 

@Infos (message = "Message methode f") 

void f () {} 

} 

class B extends A 
{ @Override 
void f () {} 

} 

@Retention (RetentionPolicy .RUNTIME) 
@ Inherited 
("■interface Infos 

{ String message () default "Rien" ; 
int value () default 0 ; 

} 

Annotations de la classe A : 
j ava . lang . Deprecated 
Infos 

Annotations de la methode A.f : 

j ava . lang . Deprecated 

Infos 

Annotations de la classe B : 
Infos 

Annotations declarees de la classe B : 



Obtention des annotations presentes sur un element 
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Les droits d'acces aux membres, 

classes et interfaces 



Nous recapitulons ici les differents droits d'acces qu'on peut attribuer : 

• d'une part aux classes et interfaces, 

• d'autres part aux membres (champs et methodes) ou aux classes internes. 

1 Modificateurs d'acces des classes 
et interfaces 



Modificateur 


Signification pour une classe ou une interface 


public 


Acces toujours possible 


neant (droit de paquetage) 


Acces possible depuis les classes du meme paquetage 
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Les droits d'acces aux membres, classes et interfaces 



2 Modificateurs d'acces pour les membres 
et les classes internes 



iviooiTicaieur 


Cinnif i/intinn nnt ir i in m o m hro nil iinn o mono inlovno 

oigniTicauon pour un mernDre ou une ciasse mierne 


public 


Acces possible partout ou sa ciasse est accessible (done 
partout pour une ciasse declaree public, depuis le paque- 
tage de la ciasse pour une ciasse ayant I'acces de paque- 
tage) 


neant (droit de paquetage) 


Acces possible depuis toutes les classes du meme paque- 
tage (quel que soit le droit d'acces de la ciasse qui est au 
minimum celui de paquetage) 


protected 


Acces possible depuis toutes les classes du meme paque- 
tage ou depuis les classes derivees 


private 


Acces restreint a la ciasse ou est faite la declaration (du 
membre ou de la ciasse interne) 
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La classe Clavier 



Voici la liste de la classe Clavier que nous avons utilisee dans de nombreux programmes de 
l'ouvrage. 

Elle fournit des methodes permettant de lire sur une ligne une information de Fun des types 
int, float, double ou String. La methode de lecture d'une chaine est utilisee par les autres pour 
lire la ligne. 

// classe fournissant des fonctions de lecture au clavier 
import java.io.* ; 
public class Clavier 

{ public static String lireString () // lecture d une chaine 
{ String ligne_lue = null ; 
try 

{ InputStreamReader lecteur = new InputStreamReader (System. in) ; 
BufferedReader entree = new BufferedReader (lecteur) ; 
ligne_lue = entree . readLine ( ) ; 

} 

catch (IOException err) 
{ System. exit (0) ; 
} 

return ligne lue ; 

} 

public static float lireFloat () // lecture d un float 
{ float x=0 ; // valeur a lire 
try 

{ String ligne_lue = lireString () ; 
x = Float. parseFloat (ligne_lue) ; 

} 
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catch (NumberFormatException err) 

{ System. out. println ("*** Erreur de donnee ***") ; 
System. exit (0) ; 

} 

return x ; 

} 

public static double lireDouble () // lecture d' un double 
{ double x=0 ; // valeur a lire 
try 

{ String ligne_lue = lireString ( ) ; 
x = Double. par seDouble (ligne_lue) ; 

} 

catch (NumberFormatException err) 

{ System. out. println ("*** Erreur de donnee ***") ; 
System. exit (0) ; 

} 

return x ; 

} 

public static int lirelnt () // lecture d un int 

{ int n=0 ; // valeur a lire 
try 

{ String ligne_lue = lireString ( ) ; 
n = Integer .parselnt (ligne_lue) ; 
} 

catch (NumberFormatException err) 

{ System. out. println ("*** Erreur de donnee ***") ; 
System. exit (0) ; 

} 

return n ; 



// programme de test de la classe Clavier 
public static void main (String! ] args) 
{ System. out .println ("donnez un flottant") ; 
float x ; 

x = Clavier . lireFloat ( ) ; 
System. out .println ("merci pour " + x) ; 
System. out .println ("donnez un entier") ; 
int n ; 

n = Clavier. lirelnt () ; 

System. out .println ("merci pour " + n) ; 

} 



La classe Clavier 

La methode lireString de lecture d'une chaine utilise la demarche presentee au paragraphe 
4.3 du chapitre 20 pour lire les lignes d'un fichier texte. Mais ici Fobjet de type BufferedRea- 
der est associe au clavier plutot qu'a un fichier. Plus precisement, il existe un objet System.in, 
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de type InputStream correspondant a un flux binaire relie au clavier. En le fournissant en 
argument du constructeur de InputStreamReader, on obtient un flux texte (dote de fonction- 
nalites rudimentaires) qu'on transmet a son tour au constructeur de BufferedReader afin 
d'obtenir des possibilites de lecture de lignes (notamment, la gestion de la fin de ligne). 

En cas d' exception de type IOException (rare !), on se contente d'interrrompre le pro- 
gramme. Si nous n'avions pas traite cette exception, nous aurions du la declarer dans une 
clause throws, ce qui aurait oblige l'utilisateur de la classe Clavier a la prendre en charge 

La lecture des informations de type entier ou flottant utilise la methode Clavier.lireString, 
ainsi que les methodes de conversion de chaines Integer.parselnt, Float.parseFloat et Dou- 
ble.parseDouble. Nous devons traiter l'exception NumberFormatException qu'elles sont sus- 
ceptibles de generer. Ici, nous affichons un message et nous interrompons le programme. 

Remarque 

Depuis le JDK 5.0, il existe une classe nommee Scanner qui offre des possibilites d' ana- 
lyse de chaines de caracteres. Par exemple, avec : 

Scanner clavier = new Scanner (System. in) ; 

on construit un objet clavier associe a 1' entree standard System. in. La lecture des infor- 
mations peut alors se faire a l'aide de methodes telles que nexlnt, nextFloat, nextDou- 
ble de la classe Scanner. Par exemple : 

double ht = clavier . nextDouble () ; 

Nous avons cependant renonce a exploiter ces possibilites car le formatage des infor- 
mations fait appel a certaines caracteristiques dites de "localisation" specifiques a cha- 
que pays. Notamment, les nombres flottants utilisent un point decimal aux Etats-Unis, 
une virgule en France... 
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Les constantes 
et fonctions mathematiques 



Elles sont fournies par la classe Math. Les angles sont toujours exprimes en radians. 



Constante (double) 


Valeur 


E 


2.718281828459045 


PI 


3.141592653589793 



Norn fonction 


Role 


En-tetes 


abs 


Valeur absolue 


double abs (double a) 
float abs (float a) 
int abs (int a) 
long abs (long a) 


acos 


Arc cosinus (angle dans I'intervalle [-1, 1]) 


double acos (double a) 


asin 


Arc sinus (angle dans I'intervalle [-1, 1]) 


double asin (double a) 


atan 


Arc tangente (angle dans I'intervalle 
[-Pi/2, Pi/2]) 


double atan (double a) 
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Les constantes et fonctions mathematiques 



Norn fonction 


Role 


En-tetes 


atan2 


Arc tangente (a/b) (angle dans I'intervalle 
[-Pi/2, pi/2]) 


double atan2 (double a, double b) 


ceil 


Arrondi a rentier superieur 


double ceil (double a) 


cos 


Cosinus 


double cos (double a) 


exp 


Exponentielle 


double exp (double a) 


floor 


Arrondi a I'entier inferieur 


double floor (double a) 


lEEEremainder 


Reste de la division de x par y 


double lEEEremainder (double x, 
double y) 


log 


Logarithme naturel (neperien) 


double log (double a) 


max 


Maximum de deux valeurs 


double max (double a, double b) 
float max (float a, float b) 
int max (int a, int b) 
lona max Mono a lona b) 


min 


Minimum de deux valeurs 


double min (double a, double b) 
float min (float a, float b) 
int min (int a, int b) 
long min (long a, long b) 


pow 


Puissance (a b ) 


double pow (double a, double b) 


random 


Nombre aleatoire dans I'intervalle [0, 1 [ 


double random () 


rint 


Arrondi a I'entier le plus proche 


double rint (double a) 


round 


Arrondi a I'entier le plus proche 


long round (double a) 
int round (float a) 


sin 


Sinus 


double sin (double a) 


sqrt 


Racine carree 


double sqrt (double a) 


tan 


Tangente 


double tan (double a) 


toDegrees 


Conversion de radians en degres 


double toDegrees (double aRad) 


toRadians 


Conversion de degres en radians 


double toRadians (double aDeg) 



D 

Les exceptions standard 



Nous vous proposons la liste des principales exceptions standards des paquetages java.lang, 
java.io et java.awt. Notez que nous n'indiquons pas les exceptions implicites particulieres 
que sont les erreurs derivees de la classe Error. 



1 Paquetage standard (java.lang) 

1 .1 Exceptions explicites 

Exception 

Class NotFoundException 

CloneNotS upportedException 

IllegalAccessException 

InstantiationException 

InterruptedException 

NoSuchFieldException 

NoSuchMethodException 
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1 .2 Exceptions implicites 

Exception 

RunTimeException 

ArithmeticException 

ArrayS toreException 

ClassCastException 

Illegal ArgumentException 
IllegalThreadStateException 
NumberFormatException 

IllegalMonitorStateException 

IllegalStateException 

IndexOutOfBoundsException 

Array IndexOutOfBoundsException 
StringlndexOutOfBoundsException 

NegativeArraySizeException 

NullPointerException 

SecurityException 

UnsupportedOperationException 

2 Paquetage java.io 

Toutes les exceptions de ce paquetage sont explicites 

Exception 

IOException 

CharConversionException 
EOFException 
FileNotFoundException 
InterruptedlOException 
Obj ec tS tre amException 
InvalidClassException 
InvalidObjectException 
NotActiveException 
NotSerializableException 
OptionalDataException 
S treamCorruptedException 
WriteAbortedException 
SyncFailedException 
UnsupportedEncodingException 
UTFDataFormatException 
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3 Paquetage java.awt 



3.1 Exceptions explicites 

Exception 

AWTException 

3.2 Exceptions implicites 

Exception 

RunTimeException 

DlegalStateException 

IllegalComponentStateException 



4 Paquetage java.util 

4.1 Exceptions explicites 

Exception 

TooManyListenersException 



4.2 Exceptions implicites 

Exception 

RunTimeException 

ConcurrentModific ationException 
EmptyStackException 
MisssingResourceException 
NoS uchElementException 
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Les composants graphiques 

et leurs methodes 



Nous presentons ici les principales classes et methodes des paquetages java.awt et 
javax. swing. II ne s'agit nullement d'un dictionnaire exhaustif des tres nombreuses methodes 
proposees par Java. Bien au contraire, nous avons privilegie la clarte et la facilite de consulta- 
tion. Pour cela : 

• nous nous limitons aux methodes presentees dans l'ouvrage et a quelques methodes supple - 
mentaires dont le role est evident ; 

• lorsqu'une methode est mentionnee dans une classe, elle n'est pas rappelee dans les classes 
derivees ; 

• lorsqu'une classe se revele inutilisee en pratique (exemple Window, Frame, Dialog), ses 
methodes n'ont ete mentionnees que dans ses classes derivees ; par exemple, la methode set- 
Title est definie dans la classe Frame mais elle n'est indiquee que dans la classe JFrame. 

Nous vous foumissons d'abord l'arborescence des classes concernees, avant d'en decrire les 
differentes methodes, classe par classe (pour chacune, nous rappelons la liste de ses ance- 
tres). 
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Les composants graphiques et leurs methodes 



1 Les classes de composants 

Les classes precedees d'un asterisque (*) sont abstraites. 

*Component 
*Container 

Panel 
Applet 
JApplet 
Window 
JWindow 
Frame 

JFrame 
Dialog 
JDialog 
JComponent 
JPanel 

AbstractButton 
JButton 
JToggleButton 

JCheckBox 

JRadioButton 
JMenuItem 

JCheckBoxMenuItem 

JRadioButtonMenuItem 

J Menu 

JLabel 

JTextComponent 

JTextField 
JList 

JcomboBox 

JMenuBar 

JPopupMenu 

JScrollPane 

JToolBar 
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2 Les methodes 

*Component 





Component () 


void 


sdd (PopupMenu menuSurgissant) 


void 


addFocusListener (FocusListener ecouteur) 


void 


addKevListener (KevLi^tener pcouteuh 


void 


addMouseListener (MouseListener ecouteur) 


void 


addMouseMotionListener (MouseMotionListener ecouteur) 


Color 


getBackground () 


Rectangle 


getBounds () 


Font 




FontMetrics 


aetFontMetrics fFont fonte^ 

VJ ^11 \J 1 1 lIVIv III V V V ' ^ 1 1 L 1 ' 1 1 L \-> J 


Color 


yen \ji cy i uui iu \) 


\J I QUI I IU3 




int 


fiPtHpinht 0 
yen iciyi ii \j 


Dimpn^inn 

L> II 1 IUI IOI \J 1 1 


nptSizp 0 


Toolkit 


getToolkit () 


int 


aetX 0 


int 


aetY 0 


int 


aetWidth 0 


boolean 


hasFocus () 


boolean 


imaapUodate flmanp imanp int flan^ int x int v int larnpur int hautpur 

III W *J VI V4 IV l 1 1 1 1 v 1 1 1 1 t-iy V-/ ■ MIL II <-i y O , II 11 II 11 MIL IUI M^^l i MIL II t-i UlvUI 


void 


invalidate () 


boolean 


isEnabled () 


hnnlpan 


i^Fopu<iTi*a\/pr^ahlp (\ 

IOI VJOUO 1 1 uVCI DQUIC \ J 


boolean 


isVisible () 


void 


oaint (Grannies oontPxtpGranhinup^ 


void 


setBackground (color coulourFond) 


void 


<5PtBoijnd<5 (Rprtannlp h 


void 


setBounds (int x, int y, int largeur, int hauteur) 


void 


setCursor (Cursor curseurSouris) 


void 


setEnabled (boolean active) 


void 


setFont (Font fonte) 


void 


setForeground (Color couleurAvantPlan) 


void 


setSize (Dimension dim) 


void 


setSize (int largeur, int hauteur) 


void 


setVisible (boolean visible) 


void 


update (Graphics contexteGraphique) 


void 


validate () 
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"Container (Component) 

Container () 

Component add (Component composant) 

void add (Component composant, Object contraintes) 

Component add (Component composant, int rang) 

Component add (Component composant, Object contraintes, int rang) 

void setLayout (LayoutManager gestionnaireMiseEnForme 

void remove (int rang) 

void remove (Component composant) 

void removeAII () 

Applet {Panel -Component - Container) 

applet 0 

void destroy () 

URL getCodeBase () 

Image getlmage (URL adresseURL) 

Image getlmage (URL adresseURL, String nomFichier) 

String getParameter (String nomParametre) 

void init () 

void resize (Dimension dim) 

void resize (int largeur, int hauteur) 

void start () 

void stop 0 

JApplet {Applet -Panel - Component - Container) 
JApplet () 
Container getContentPane () 
void setJMenuBar (JMenuBar barreMenus) 

void setLayout (LayoutManager gestionnaireMiseEnForme) 

J Frame {Frame - Window - Component - Container) 
J Frame () 

JFrame (String titre) 
Container getContentPane () 
Toolkit getToolkit () 
void setContentPane (Container contenu) 

void setDefaultCloseOperation (int operationSurFermeture) 

void setJMenuBar (JMenuBar barreMenus) 

void setLayout (Layout gestionnaireMiseEnForme) 

void setTitle (String titre) // heritee de Frame 

void update (Graphics contexteGraphique) 
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JDialog {Dialog - Window - Container) 

JDialog (Dialog proprietaire, boolean modale) 
JDialog (Frame proprietaire, boolean modale) 
JDialog (Dialog proprietaire, String titre, boolean modale) 
JDialog (Frame proprietaire, String titre, boolean modale) 

void dispose () 

Container getContentPane () 

void setDefaultCloseOperation (int operationSurFermeture) 

void setLayout (LayoutManager gestionnaireMiseEnForme) 

void setJMenuBar (JMenuBar barreMenus) 

void setTitle (String titre) // heritee de Dialog 

void show () 

void update (Graphics contexteGraphique) 

JComponent {Container - Component) 





JComponent () 


Graphics 


getGraphics () 


Dimension 


getMaximumSize () 


Dimension 


getMinimumSize () 


Dimension 


getPreferredSize () 


void 


paintBorder (Graphics contexteGraphique) 


void 


paintChildren (Graphics contexteGraphique) 


void 


paintComponent (Graphics contexteGraphique) 


void 


revalidate () 


void 


setBorder (Border bordure) 


void 


setMaximumSize (Dimension dimensions) 


void 


setMinimumSize (Dimension dimensions) 


void 


setPreferredSize (Dimension dimensions) 


void 


setToolTipText (String texteBulleDAide) 



J Panel (Jcomponent - Container - Component) 
J Panel () 

JPanel (LayoutManager gestionnaireMiseEnForme) 
AbstractButton (Jcomponent - Container - Component) 





AbstractButton () 


void 


addActionListener (ActionListener ecouteur) 


void 


addltemListener (ItemListener ecouteur) 


String 


getActionCommandO 


String 


getText() 


boolean 


isSelectedQ 


void 


setActionCommand (String chaineDeCommande) 


void 


setEnabled (boolean active) 
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void setMnemonic (char caractereMnemonique) 

void setSelected (boolean selectionne) 

void setText (String libelle) 

JButton (AbstractButton - JComponent - Container - Component) 
JButton () 

JButton (String libelle) 

JCheckBox (JToggleButton - AbstractButton - JComponent - Container - 
Component) 

JCheckBox () 

JCheckBox (String libelle) 

JCheckBox (String libelle, boolean selectionne) 

JRadioButton (JToggleButton - AbstractButton - JComponent - Container - 
Component) 

JRadioButton (String libelle) 

JRadioButton (String libelle, boolean selectionne) 

J Label (JComponent - Container - Component) 

JLabel (String texte) 
void setText (String libelle) 

JTextField (JTextComponent - JComponent - Container - Component) 
JTextField () 

JTextField (int nombreColonnes) 
JTextField (String textelnitial) 
JTextField (String textelnitial, int nombreColonnes) 
Document getDocument () // heritee de JTextComponent 

String getText () //heritee de JTextComponent 

void setColumns (int nombreCaracteres) 

void setEditable (boolean editable) //heritee de JTextComponent 

void setText (String texte) //heritee de JTextComponent 

J List (JComponent - Container - Component) 
J List () 

JList (Object[] donnees) 
void addListSelectionListener (ListSelectionListener ecouteur) 

void setSelectedlndex (int rang) 

int getSelectedlndex () 

int[] getSelectedlndices () 

Object getSelectedValue () 
Object [] getSelectedValues () 
boolean getValuelsAdjusting () 
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void setSelectedlndex (int rang) 

void setSelectedlndices (int [] rangs) 

void setSelectionMode (int modeDeSelection) 

void setVisibleRowCount (int nombreValeurs) 

JComboBox (JComponent - Container - Component) 
JComboBox () 

JComboBox (Object[] donnees) 
void addltem (Object nouvelleValeur) 

int getSelectedlndex () 

Object getSelectedltem () 

void insertltemAt (Object nouvelleValeur, int rang) 

void removeltem (Object valeurASupprimer) 

void removeltemAt (int rang) 

void removeAllltems () 

void setEditable (boolean editable) // heritee cte JTextComponent 

void setSelectedlndex (int rang) 

J Menu Bar (JComponent - Container - Component) 
JMenuBar () 

JMenu add (JMenu menu) 
JMenu getMenu (int rang) 



JMenu ( J Menu Item - AbstractButton - JComponent - Container - Component) 
JMenu () 





JMenu (String nomMenu) 


JMenultem 


add (Action action) 


JMenultem 


add (JMenultem option) 


void 


addMenuListener (MenuListener ecouteur) 


void 


addSeparator () 


Keystroke 


getAccelerator () 


void 


insert (Action action, int rang) 


void 


insert (JMenultem option, int rang) 


void 


insertSeparator (int rang) 


boolean 


isSelected () 


void 


remove (int rang) 


void 


remove (JMenultem option) 


void 


removeAII () 


void 


setAccelerator (Keystroke combinaisonTouches) 


void 


setEnabled (boolean active) 


void 


setSelected (boolean selectionne) 
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JPopupMenu {JComponent - Container - Component) 
JPopupMenu () 
JPopupMenu (String nom) 
JMenultem add (Action action) 
JMenultem add (JMenultem option) 



void addPopupMenuListener (PopupMenuListener ecouteur) 

void addSeparator () 

void insert (Action action, int rang) 

void insert (Component composant, int rang) 

void remove (Component composant) 

void setVisible (boolean visible) 

void show (Component composant, int x, int y) 



JMenultem {AbstractButton - JComponent - Container - Component) 
JMenultem () 

JMenultem (String nomOption) 

JMenultem (Icon icone) 

JMenultem (String nomOption, Icon icone) 

JMenultem (String nomOption, int caractereMnemonique) 
void setAccelerator (Keystroke combinaisonTouches) 

keystroke getAccelerator () 

JCheckBoxMenultem ( JMenultem - AbstractButton - JComponent - Container - 
Component) 

JChekBoxMenultem () 
JChekBoxMenuitem (String nomOption) 
JChekBoxMenultem (Icone icone) 
JChekBoxMenultem (String nomOption, Icon icone) 
JChekBoxMenultem (String nomOption, boolean active) 
JChekBoxMenuitem (String nomOption, Icon icone, boolean active) 

JRadioButtonMenultem ( JMenultem - AbstractButton - JComponent - 

Container - Component) 

JRadioButtonMenultem () 

JRadioButtonMenultem (String nomOption) 

JRadioButtonMenultem (Icone icone) 

JRadioButtonMenultem (String nomOption, Icon icone) 

JRadioButtonMenultem (String nomOption, boolean active) 

JRadioButtonMenultem (String nomOption, Icon icone, boolean 
active) 
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JScrollPane 



JToolBar 



JButton 

void 

void 

boolean 

void 

void 



JScrollPane () 
JScrollPane (Component) 



JToolBar () 

JToolBar (int orientation) 
add (Action action) 
addSeparator () 

addSeparator (Dimension dimensions) 
isFloatable () 

remove (Component composant) 
setFloatable (boolean flottante) 
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Les evenements et les ecouteurs 



Nous vous fournissons tout d'abord deux tableaux de synthese, le premier pour les evene- 
ments de bas niveau, le second pour les evenements semantiques. lis fournissent pour cha- 
cune des principales interfaces ecouteurs correspondantes : 

• le nom de l'interface ecouteur et le nom de la classe adaptateur (si elle existe), 

• les noms des methodes de l'interface, 

• le type de l'evenement correspondant, 

• les noms des principales methodes de l'evenement, 

• les composants concernes. 

Vous trouverez ensuite les en-tetes completes des methodes des classes evenement. 
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1 Les evenements de bas niveau 



Ecouteur 
(adaptateur) 


Methode ecouteur 


Type 

evenement 


Methodes 
evenement 


Composants 
concernes 


MouseListener 
(MouseAdapter) 


mouseClicked 

mousePressed 

mouseReleased 

mniiQpFntprpd 

mouseExited 


MouseEvent 


getClickCount 

getComponent 

getModifiers 

npt^niirrp 

getx 


Component 


MouseMotionListener 
(MouseMotionAdapter) 


mouseDragged 
mouseMoved 




getY 

getPoint 

isAltDown 

isAltGraphDown 

isControlDown 

isMetaDown 

isPopupTrigger 

isShiftDown 




KeyListener 
(KeyAdapter) 


keyPressed 

keyReleased 

keyTyped 


keyEvent 


getComponent 

getSource 

getKeyChar 

getKeyCode 

getKeyModifiers- 
Text 

getKeyText 

getModifiers 

isAltDown 

isAltGraphDown 

isControlDown 

isShiftDown 

isMetaDown 

isActionKey 


Component 


FocusListener 
(FocusAdapter) 


focusGained 
focusLost 


FocusEvent 


getComponent 

getSource 

isTemporary 


Component 
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Ecouteur 
(adaptateur) 


Methode ecouteur 


Type 

evenement 


Methodes 
evenement 


Composants 
concernes 


WindowListener 
(WindowAdaptei) 


windowOpened 

windowClosing 

windowClosed 

windowActivated 

window- 
Deactivated 

windowlconified 

window- 

Deiconified 


WindowEvent 


getComponent 

getSource 

getWindow 


Window 



2 Les evenements semantiques 

Dans la demiere colonne de ce tableau, les termes generiques Boutons et Menus designent les 
classes suivantes 

• Boutons : JButton, JCheckBox, JRadioButton, 

• Menus : JMenu, JMenuItem, JCheckBoxMenuItem, JRadioButtonMenuItem. 



Ecouteur 
(adaptateur) 


Methode ecouteur 


Type 

evenement 


Methodes 
evenement 


Composants 
concernes 


Action- 
Listener 


actionPerformed 


ActionEvent 


getSource 
getAction- 
Command 

getModifiers 


Boutons 

Menus 

JTextField 


ItemListener 


itemStateChanged 


ItemEvent 


getSource 
getltem 

getStatEchange 


Boutons 
Menus 
J List 

JComboBox 


List- 

Selection- 
Listener 


valueChanged 


ListSelection- 
Event 


getSource 

getValuels- 
Adjusting 


J List 


Document- 
Listener 


changeUpdate 

insertUpdate 

removeUpdate 


DocumentEvent 


getDocument 


Document 


Menu- 
Listener 


menuCanceled 
menuSelected 
menuDeselected 


MenuEvent 


getSource 


JMenu 



742 



Les evenements et les ecouteurs 



Ecouteur 
(adaptateur) 


Methode ecouteur 


Type 

evenement 


ivieinoues 
evenement 


Composants 
concernes 


PopupMenu- 
Listener 


popupMenu- 
Canceled 

popupMenuWill- 
BecomeVisible 

popupMenuWill- 
Becomelnvisible 


PopupMenu- 
Event 


getSource 


JPopup- 
Menu 



3 Les methodes des evenements 



MouseEvent 



int 

Component 
int 

Object 

int 

int 

Point 

boolean 

boolean 

boolean 

boolean 

boolean 

boolean 



KeyEvent 



Component 

Object 

char 

int 

String 
int 

boolean 
boolean 
boolean 



getClickCount () 
getComponent () 
getModifiers () 
getSource () 
getX 0 

getv 0 

getPoint () 
isAltDown () 
isAltGraphDown () 
isControlDown () 
isMetaDown () 
isPopupTrigger () 
isShiftDown () 

getComponent () 
getSource () 
getKeyChar () 
getKeyCode () 

getKeyText (int codeToucheVirtuelle) 
getModifiers () 
isAltDown () 
isAltGraphDown () 
isControlDown () 
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boolean 
boolean 

FocusEvent 

Component 

Object 

boolena 

WindowEvent 

Component 

Object 

Window 

ActionEvent 

Object 
String 
int 

ItemEvent 

Object 
Object 
int 

ListSelection Event 

Object 
boolean 

DocumentEvent 

Document 

MenuEvent 

Object 

PopuMenuEvent 

Object 



isMetaDown () 
isShiftDown () 



getComponent () 
getSource () 
isTemporary () 

getComponent () 
getSource () 
getWindow () 

getSource () 
getActionCommand () 
getModifiers () 

getSource () 
getltem () 

getStateChanged () 

getSource () 
getValuelsAdjusting () 

getDocument () 

getSource () 

getSource () 
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Les collections 



Nous presentons ici les principales interfaces, classes et methodes relatives aux collections 
(listes, vecteurs dynamiques et ensembles) et aux tables associatives, ainsi que les algorith- 
mes de la classe Collections. Ces classes et collections appartiennent toutes au paquetage 
java.util. 

Pour chaque classe ou interface, nous rappelons (entre parentheses) la liste des ancetres 
(exception faite de la classe Object). Lorsqu'une methode est mentionnee dans une classe ou 
une interface, elle n'est plus rappelee dans les classes ou interfaces derivees. Les methodes 
hashCode et equals, communes a toutes les classes puisque heritees de Object, ne sont pas 
rappelees ici. Par souci de lisibilite, nous avons prefere distinguer des autres les versions 
anterieures au JDK 5.0. 

Enfin, certaines interfaces ou classes d'utilisation peu frequentes ne sont pas decrites ici. II 
s'agit de l'ancienne Finterface Enumeration, des classes "squelettes" fournissant une imple- 
mentation minimum d'une interface (AbstractCollection, AbstractList...), des classes 
specialisees pour les enumerations (EnumMap, EnumSet...), des collections liees aux threads 
et appartenant au paquetage java.util.concurrent. II en va de meme pour certains algorithmes 
tres specialises. 
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1 Depuis le JDK 5.0 



1.1 Les interfaces 



Collection <E> 

boolean 
boolean 



void 
boolean 

boolean 

boolean 

lterator<E> 

boolean 

boolean 

boolean 

int 

Object [ ] 
<T>T[] 



List <E>(Collection) 

void 
boolean 

E 
int 

int 



add (E elem) // ajoute elem a la collection 

add All (Collection <? extends E> c) //ajoute tous les elements de c 

//a la collection 

clear () // supprime tous les elements 

contains (Object elem) //true si elem appartient a la collection 

//false sinon 

containsAII (Collection <?> c) //true si tous les elements de c 

// appartiennent a la collection - 
// false sinon 

//true si la collection est vide - false sinon 

// fournit un iterateur monodirectionnel 



isEmpty () 
iterator () 
remove (Object elem) 



//supprime elem s'il existe et remote 
//true - sinon renvoie false 



removeAII (Collection <?> c) //supprime de la collection tous les 

// elements presents dans c 

retain All (Collection <?> c) // ne conserve dans la collection que 

// les elements presents dans c 

// fournit le nombre d'elements 



size () 
toArray () 

toArray (T [] a) 



// fournit un tableau contenant une copie 
// des elements de la collection 

// si a est assez grand, y place une copie 
// des elements de la collection 
// si a est trop petit, cree un nouveau tableau 
// fournit la reference au tableau utilise 



add (int index, E elem) //ajoute elem a la position index 

addAII (int index, Collection <? extends E> c) 

// ajoute tous les elements deck parti r de la position index 



get (int index) 
indexOf (Object elem) 

lastlndexOf (Object elem) 



Listlterator<E>listlterator () 
Listlterator<E>listlterator (int index) 
E remove (int index) 

E set (int index, E elem) 

List<E> subList (int debut, int fin) 



// fournit /'element de rang index 

// fournit le rang du premier element 
// valant elem 

// fournit le rang du dernier element 
// valant elem 

// fournit un iterateur bidirectionnel 

//cree un iterateur, initialise a index 

//supprime I'objet de rang index et 
// en fournit la valeur 

// remplace /'element de rang index 
//par elem 

// fournit une vue d'une sous-liste 
//de la liste d'origine, constitute 
//des elements de rang debut a fin 
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Queue <E> (Collection) 



Deque <E: 



E 


element () 


boolean 


offer (E elem) 


E 


peek () 


E 


poll 0 


E 


remove () 


:> (Queue) 




void 


addFirst (E elem) 


void 


addLast (E elem) 


E 


getFirst () 


E 


getLast () 


boolean 


offerFirst (E elem) 


boolean 


offerLast (E elem) 


E 


peekFirst () 


E 


peekLast () 


E 


pollFirst () 


E 


pollLast () 


E 


removeFirst () 


E 


removeLast () 



// fournit, sans le supprimer, le 
//premier element de la queue 

//place elem dans la queue, si possible ; 
// et renvoie true ; renvoie false sinon 

// fournit le premier element de la queue, 
//sans le supprimer (null si queue vide) 

// fournit le premier element de la queue, 
//en le supprimant ('null si queue vide) 

//fournit le premier element de la queue, en 
//le supprimant (exception si queue vide) 



// ajoute elem en tete 

// (exception si queue pleine) 

//ajoute elem en queue 

// (exception si queue pleine) 

// fournit /'element de tete, sans le 
// supprimer (exception si queue vide) 

// fournit /'element de queue, sans le 
//supprimer (exception si queue vide) 

// ajoute elem en tete, si possible 
// et renvoie true ; renvoie false sinon 

//ajoute elem en queue, si possible 
// et renvoie true ; renvoie false sinon 

// fournit /'element de tete, sans le 
// supprimer (null si queue vide) 

// fournit /'element de queue, sans le 
//supprimer (null si queue vide) 

// fournit /'element de tete, en le 
// supprimant (null si queue vide) 

// fournit /'element de queue, en le 
//supprimant (null si queue vide) 

// fournit /'element de tete, en le 

// supprimant (exception si queue vide) 

// fournit /'element de queue, en le 
//supprimant (exception si queue vide) 



Set<E> (Collection) 

pas de methodes supplementaires par rapport a Collection 

SortedSet<E> (Set - Collection) 

Comparator? super E> comparator () //fournit le comparateur prevu a la 

//construction s'il existe - null sinon 

E first () // fournit le premier element 
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SortedSet<E>headSet (E max) 

E last () 

SortedSet<E> subSet (E min, E max) 

SortedSet<E> tailSet (E min) 

NavigableSet<E> (SortedSet) 

E ceiling (E elem) 



// four nit une vue de /'ensemble 
// des valeurs inferieures a max 

// fournit le dernier element 

// fournit une vue de /'ensemble 
//des valeurs entre min (inclu) 
// et max (exclu) 

// fournit une vue de /'ensemble des 
// valeurs sup. ou egales a min 



lterator<E> descendinglterator () 
NavigableSet<E> descendingSet () 
E floor (E elem) 



// fournit le plus petit element superieur 
//ou egal a elem ('null si aucun) 

// fournit un iterateur dans I'ordre inverse 

// fournit une vue dans I'ordre inverse 

// fournit le plus grand element inferieur 
//ou egal a elem ('null si aucun) 

NavigableSet <E> headSet (E elmax, boolean inclus) 

// fournit une vue de la partie de /'ensemble dont les elements sont 
//inferieurs (ou egaux si inclus vaut Xrue) a elmax 

E higher (E elem) // fournit le plus petit element superieur 

//a elem ('null si aucun) 

E lower (E elem) // fournit le plus grand element inferieur 

//a elem (null si aucun) 

E pollFirst () // fournit, en le supprimant, le plus 

//petit element (hull si ensemble vide) 

E pollLast () //fournit, en le supprimant, le plus 

//grand element ('null si ensemble vide) 

SortedSet<E> subSet (E debut, E fin) // fournit une vue de la portion de 

// /'ensemble dont les elements sont superieurs 
//a debut et inferieurs a fin 

SortedSet<E> tailSet (E debut) // fournit une vue de la portion de I'ensemble 

// dont les elements sont superieurs a debut 

NavigableSet<E> tailSet (E elmin, boolean inclus) 

// fournit une vue de la partie de I'ensemble dont les elements sont 
//superieurs (ou egaux si inclus vaut true,) a elmin 



Map <K,V> 



void clear () 

boolean containsKey (Object cle) 

boolean containsValue (Object valeur) 

set<Map.Entry<K, V»entrySet () 



V 

boolean 
set<K> 



get (Object cle) 
isEmpty () 
keySet () 



// supprime tous les elements 

//true si la cle appartient a la table 
//false sinon 

//true si valeur appartient a la table 
//false sinon 

//fournit une vue des "paires" de la 
// table, sous forme d'un ensemble 
// d' elements de type Map. Entry 

// fournit la valeur associee a cle 

// true si la table est vide, false sinon 

// fournit une vue des cles de la table 
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V put (K cle, V valeur) // ajoute (cle, valeurj dans la table 

void putAII (Map<? extends K, ? extends V> m) 

//ajoute tous les elements de m 

K remove (Object cle) // supprime I'element de cle indiquee 

int size () //fournit le nombre d'elements 

Col lection<V> values () //fournit une vue des valeurs de la table 

SortedMap <K,V> 

Comparator? super K> comparator // fournit le comparateur prevu a la 

//construction s'il existe - null sinon 

K f irstKey () // fournit la premiere cle si elle existe 

//null sinon 

SortedMap<K,V>headMap (K cleMax) //fournit une vue des elements de 

// cle inferieure a cleMax 

K lastKey () // fournit la derniere cle 

SortedMap<K,V>subMap (K cleMin, K cleMax) //fournit une vue des 

//elements de cle sup. ou egale a cleMin et inferieure a cleMax 

SortedMap<K,V>tailMap (K cleMin) //fournit une vue des elements 

//de cle sup. ou egale a cleMin 

NavigableMap <K, V> (SortedMap) 

Map.entry<K,V> ceilingEntry (K cle) // fournit la "paire" correspondant a la plus 

//petite cle superieure ou egale a cle (null si aucune) 

NavigableSet<K> descendingKeySet () //fournit une vue de /'ensemble 

// des cles dans I'ordre inverse 

NavigableMap<K,V>descendingMap () //fournit une vue dans I'ordre inverse 

Map.entry<K,V> firstEntry () // fournit la "paire" correspondant a la plus 

//petite cle (null si map vide) 

Map.entry<K,V> f loorEntry (K cle) // fournit la "paire" correspondant a la plus 

//petite cle superieure ou egale a cle (null si aucune) 

K f loorKey (K cle) // fournit la plus petite cle superieure 

//ou egale a cle (nu//si aucune) 

SortedMap<K,V> headMap (K clemax) //fournit une vue formee des elements 

// dont la cle est inferieure a clemax 

NavigableMap<K,V> headMap (K clemax, boolean inclus) 

// fournit une vue formee des elements dont la cle est inferieure 
// (ou egale si inclus est vrai) a clemax 

Map.Entry<K,V> higherEntry (K cle) //fournit la "paire" correspondant a la 

//plus petite cle superieure a cle (null si aucune) 

K higherKey (K cle) // fournit la plus petite cle superieure a 

//cle (null si aucune) 

Map.entry<K,V> lastEntry () // fournit la "paire" correspondant a la plus 

// grande cle (null si map vide) 

Map.Entry<K,V> lowerEntry (K cle) //fournit la "paire" correspondant a la 

//plus grande cle inferieure a cle (null si aucune) 

K lowerKey (K cle) // fournit la plus grande cle inferieure a 

//cle (null si aucune) 

NavigableSet<K> navigableKeySet () //fournit une vue des cles 
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Map.Entry<K,V> pollFirstEntry () // fournit, en la supprimant, la "paire" 

// correspondant a la plus petite cle (null si map vide) 

Map.Entry<K,V> pollLastEntry () //fournit, en la supprimant, la "paire" 

//correspondant a la plus grande cle ('null si map vide) 

NavigableMap<K,V> subMap (K cledeb, boolean inclusd, K olefin, boolean inclusf) 
// fournit une vue de la partie du map formee des elements dont 
//la cle est superieure (ou egale si inclusd est vrai) a cledeb 
// et inferieure (ou egale si inclusf est vrai) a clef in 

SortedMap<K,V> tailMap (K cledeb) // fournit une vue de la partie du map 

// dont les elements ont une cle superieure a cledeb 

NavigableMap<K,V> tailMap (K cledeb, boolean inclus) 

// fournit une vue de la partie du map dont les elements 
//ont une cle superieure (ou egale si inclus est vrai) a cledeb 



Map. Entry <K, V> 

K 
V 
V 



Iterator <E> 



boolean 
E 

void 



getKey () 
getValue () 
setValue (V val) 



hasNext () 
next 0 
remove () 



Listlterator <E> (Iterator) 



void 
boolean 

int 



int 



void 



add (E elem) 
hasPrevious () 

nextlndex () 

previous () 

previouslndex () 

set (E elem) 



// fournit la cle d'un element de type Map. Entry 

// fournit la valeur d'un element de type Map. Entry 

// remplace par val la valeur d'un element 
//de type Map.Entry 



//true si la position courante designe un element 
// fournit /'element courant et avance I'iterateur 
// supprime /'element courant 



// ajoute elem a la position courante 

//true s'il existe un element precedant 
// la position courante 

// fournit le rang de /'element courant (celui qui 
// serait renvoye par un prochain appel de next,) 

// fournit /'element precedant la position 
//courante ety deplace I'iterateur 

// fournit le rang de /'element precedant /'element 
// courant (celui qui serait renvoye par un prochain 
// appel de previous,) 

// remplace I'element courant par elem 



1 .2 Les classes implementant List 

Comme List derive de Collection, ces classes implementent aussi Collection. Les methodes 
prevues dans List et dans Collection ne sont pas rappelees ici. Notez que la classe LinkedList 
implemente egalement l'interface Queue, depuis le JDK 5.0, ainsi que l'interface Deque 
depuis Java 6. Les methodes prevues dans ces differentes interfaces ne sont pas rappelees ici. 
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Vector {implements List) 



void 


addElement (E elem) 


// ajoute elem a la collection 


int 


capacity () 


// fournit la capacite courante 


void 


copylnto (Object [] t) 


// copie les elements du vecteur 
// dans le tableau t 


E 


elementAt (int index) 


// fournit 1 'element de rang index 


void 


ensureCapacity (int capMin) 


// ajuste la capacite a capMin 
// (si elle est inferieure) 


E 


firstElement () 


// fournit le premier element 


int 


indexOf (Object elem, int index) 


// fournit le rang du premier element 
// egal a elem, a partir du rang index 



void insertElementAt (E elem, int index) // ajoute elem avant 

// /'element de rang index 

E lastElement () // fournit le dernier element du vecteur 

void removeAIIEIements () // supprime tous les elements 

boolean removeElement (Object elem) //supprime le premier element egal 

//a elem 

void removeElementAt (int index) // supprime /'element de rang index 

void setElementAt (E elem, int index) // remplace par elem 

// 7 'element de rang index 

void setSize (int nouvelleTaille) // ' modifie la faille du vecteur 

// (peut supprimer des elements) 

void trimToSize () // ajuste la capacite du vecteur 

//a sa faille actuelle 

Vector () // construit un vecteur vide 

Vector (int capacitelnitiale) // construit un vecteur vide ayant 

//la capacitelnitiale indiquee 

Vector (Collection<? extends E> c) //construit un vecteur forme des 

// elements de la collection c 

Vector (int capacitelnitiale, int increment) //construit un vecteur vide 
//ayant la capacitelnitiale indiquee et utilisera 
// la valeur increment lorsqu'il faudra en accroitre la capacite 

LinkedList <E> (implements List, Queue (Java 5), Deque (Java6)) 

void addFirst E elem) //ajoute elem en debut de liste 

void addLast (E elem) // ajoute elem en fin de liste 

E getFirst () // fournit le premier element de la liste 

// s'il existe (null sinon) 

E getLast () // fournit le dernier element de la liste 

//s'il existe (null sinon) 

LinkedList () //construit une liste vide 

LinkedList (Collection <? extends E> c) // fournit une liste formee 

// des elements de c 

E removeFirst () //supprime le premier element de la liste 

//et en fournit la valeur (null si liste vide) 

E removeLast () //supprime le dernier element de la liste 

// et en fournit la valeur (null si liste vide) 
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ArrayList (implements List) 



Array List () //construit un vecteur vide 

ArrayList (int capacitelnitiale) //construit un vecteur vide 

// de capacite mentionnee 

ArrayList (Collection <? extends E> c) //construit un vecteur forme 

// des elements de c 

void ensureCapacity (int capaciteMini) // ajuste la capacite a capaciteMini 

// ( si elle est actuellement 
inferieure) 

void trimToSize () // ajuste la capacite du vecteur 

// a sa taille actuelle 



1 .3 Les classes implementant Set 

Comme Set et SortedSet derivent de Collection, ces classes implementent aussi Collection. 
Les methodes prevues dans Set et dans Collection ne sont pas rappelees ici. 

HashSet <E> (implements Set) 

HashSet () // construit un ensemble vide 

HashSet (int capalnitiale) //construit un ensemble vide avec une 

// table de hachage de capalnitiale seaux 

HashSet (Collection <? extends E> c) //construit un ensemble 

// forme des elements de c 

HashSet (int capalnitiale, float fCharge) //construit un ensemble vide 
//avec une table de hachage de capalnitiale seaux 
// et un facteur de charge de f Charge 

TreeSet <E>(implements SortedSet, NavigableSet (Java 6)) 

TreeSet () // construit un ensemble vide 

TreeSet (Collection <? extends E> c) //construit un ensemble 

// forme des elements de c 

TreeSet (Comparator <? super E> comp)// construit un ensemble vide 
// qui utilisera le comparateur comp pour ordonner ses elements 

TreeSet (SortedSet <E> s) //construit un ensemble forme des 

// elements de s et utilisant le meme comparateur 



1 .4 Les classes implementant Queue 

PriorityQueue <E> (implements Queue) 

Comparator <? super E> comparator () // fournit le comparateur utilise pour 

// ordonner la queue (null s'il s'agit de I'ordre nature!) 

PriorityQueue () // construit une queue vide, avec la capacite 
// initiate 11 

PriorityQueue (Collection <? extends E> c) 

// cree une queue avec les elements de c 
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PriorityQueue (int capacitelnitiale) // cree une queue vide, avec la 

// capacite initiate mentionnee 

PriorityQueue (int capacitelnitiale, 

Comparator? super E> comparator) 
// cree une queue vide avec la capacite initiale mentionnee, 
// en utilisant comparator pour ordonnancer ses elements 

PriorityQueue (PriorityQueue <? extends E> c) 

// cree une queue avec les elements de c 

PriorityQueue (SortedSet <? extends E> c) 

//cree une queue avec les elements de c 

1 .5 Les classes implementant Deque 
ArrayDeque <E> 

Array Deque () // construit une queue vide 

ArrayDeque (Collection <? extends E> c) // construit une 

//queue formee des elements de c 

ArrayDeque (int capacitelnitiale) // contruit une queue vide 

//avec la capacite mentionnee 

ArrayDeque<E> clone () // fournit une copie de la queue 

lterator<E> descendinglterator () // fournit un iterateur dans I'ordre inverse 

boolean removeFirstOccurrence (Object elem) 

//supprime la premiere occurrence de elem si elle existe 
// et fournit true (false sinon) 

boolean removeLastOccurrence (Object elem) 

//supprime la derniere occurrence de elem si elle existe 
// et fournit true (false sinon) 

1 .6 Les classes implementant Map 

Attention, ces classes n'implementent plus l'interface Collection, mais Finterface Map ou 
son interface derivee SortedMap. Les methodes prevues dans Map et dans SortedMap ne sont 
pas rappelees ici. 

HashMap {implements Map) 

HashMap () //construit une table vide 

HashMap (int capalnitiale) //construit une table vide, avec une table 

//de hachage de capalnitiale seaux 

HashMap (Map <? extends K, ? extends V> m) 

//construit une table formee des elements de m 

HashMap (int capalnitiale, float fCharge) //construit une table vide 

//avec une table de hachage de capalnitiale seaux 
// et un facteur de charge de fCharge 
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TreeMap {implements SortedMap, NavigableMap (Java 6)) 
TreeMap () // construit une table vide 

TreeMap (Comparator <? super K> comp) //construit une table vide 

// qui utilisera le comparateur comp pour ordonner ses elements 

TreeMap (Map <? extends K, ? extends V> m) 

// construit une table formee des elements de m 

TreeMap (SortedMap <K, ? extends V> s) //construit une table formee 
// des elements de s et utilisant le meme comparateur 



1 .7 Les algorithmes de la classe Collections 

Toutes ces methodes sont des methodes generiques ayant I'attribut static que nous ne 
rappelons pas, par souci de simplification. En revanche, les declarations de parame- 
tres de type, lorsqu'elles existent, sont indiquees sur la ligne precedant I'en-tete de 
I'algorithme. 

<T> 

boolean addAII (Collection <? super T> c, T... elem) 

// ajoute les elements elem a la collection c 

<T> 

int binarySearch (List <? extends Comparable <? super T » liste, T elem) 

// effectue une recherche de la valeure\em, en se basantsur 
// I'ordre induit par la methode compareTo des elements ou par 
// un comparateur ; fournit une valeur positive representant sa 
// position dans la collection, si elle existe ; fournit une valeur 
// negative indiquant ou elle pourrait s'inserer, si elle n'existe pas 

<T> 

int binarySearch (List <? extends T>liste, T elem, 

comparator <? super T> comp) 
// meme chose que I'algorithme precedent, mais en se basant 
// sur I'ordre induit par le comparateur comp 

<T> 

void copy (List <? super T> but, List <? extends T> source) 

// recopie tous les elements de source a la meme position de but 
// (qui doit posseder au moins autant d'elements que source,) 

boolean disjoint (Collection <?> c1 , Collection <?> c2) 

// fournit true si les deux collections c1 ef c2 n'ont aucun element 
// commun / false dans le cas contraire 

<T> 

void fill (List <? super T> liste, T elem) 

// remplace tous les elements de la collection par elem 

int frequency (Collection <?> c, Object elem) 

// fournit le nombre d'elements de la collection c egaux a elem 

<T extends Object & Comparable <? super T» 

T max (Collection <? extends T> c) 

// fournit le plus grand element de la collection, en se basant sur 
//I'ordre induit par la methode compareTo ou par un comparateur 
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<T> 

T max (Collection <? extends T> c, Comparator <? super T> comp) 

// meme chose que I'algorithme precedent, mais en se basant 
// sur I'ordre induit par le comparateur comp 

<T extends Object & Comparable <? super T» 

T min (Collection <? extends T> c) 

// fournit le plus petit element de la collection, en se basant sur 
//I'ordre induit par la methode compareTo ou par un comparateur 

<T> 

T min (Collection <? extends T> c, Comparator <? super T> comp) 

// meme chose que I'algorithme precedent, mais en se basant 
// sur I'ordre induit par le comparateur comp 

<T> 

List <T> nCopies (int n, T elem) 

// fournit une liste non modifiable, formee de n elements 
//de valeure\em 

<T> 

boolean replaceAII (List <T> liste, T vala, T vain) 

// remplace toutes les occurences de vala dans liste par vain 

void reverse (List <?> liste) 

// inverse I'ordre (naturel) des elements de la collection 

<T> 

Comparator<T>reverseOrder () 

// fournit un objet comparateur inversant I'ordre induit sur la 
// collection par la methode compareTo des objets ou par un 
// comparateur 

<T> 

Comparator<T>reverseOrder (Comparator <T> comp) 

// fournit un objet comparateur inversant I'ordre inverse de 
// celui qui serait induit par le comparateur comp 

void rotate (List <?> list, int d) 

// effectue une permutation circulaire des elements de la liste 
// suivant le decalage d mentionne 

void shuffle (List <?> liste) 

// melange la collection, de maniere aleatoire 

<T> 

Set <T> singleton (T elem) 

// fournit un ensemble non modifiable comportant le 
// seul element elem 

<T extends Comparable <? super T» 

void sort (List <T> liste) 

// trie la collection, en se basant sur I'ordre induit par la methode 
//compareTo de ses elements ou par un comparateur 

<T> 

void sort (List <T> liste, Comparator <? super T> comp) 

// trie la collection, en se basant sur I'ordre induit par 
// le comparateur comp 

void swap (List <?> liste, int i, int j) 

// echange les elements de position i ef j de liste 
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<T> 

Collection<T>synchronizedCollection (Collection <T> c) 

// fournit une vue de c, dans laquelle les methodes peuvent etre 
//utilisees par plusieurs threads 

<T> 

List <T> synchronizedList (List <T> I) 

//fournit une vue de I, dans laquelle les methodes peuvent etre 
//utilisees par plusieurs threads 

<K, V> 

Map <K, V> synchronizedMap (Map <K, V> m) 

// fournit une vue de m, dans laquelle les methodes peuvent etre 
//utilisees par plusieurs threads 

<T> 

Set <T> synchronizedSet (Set <T> e) 

// fournit une vue de e, dans laquelle les methodes peuvent etre 
//utilisees par plusieurs threads 



<K, V> 

SortedMap <K, V> synchronizedSortedMap (SortedMap <K, V> m) 

// fournit une vue de m, dans laquelle les methodes peuvent etre 
//utilisees par plusieurs threads 

<T> 

SortedSet <T>synchronizedSortedSet (SortedSet <T> e) 

// fournit une vue de e, dans laquelle les methodes peuvent etre 
//utilisees par plusieurs threads 

<T> 

Collection<T>unmodifiableCollection (Collection < ? extends T> c) 
// fournit une vue non modifiable de c 

<T> 

List <T> unmodif iableList (List <? extends T> I) 

// fournit une vue non modifiable de I 

<K, V> 

Map <K,V> unmodif iableMap (Map < ? extends K, ? extends V> m) 
// fournit une vue non modifiable de m 

<T> 

Set <T> unmodifiableSet (Set <? extends T> e) 

// fournit une vue non modifiable de e 

<K, V> 

SortedMap <K, V>unmodif iableSortedMap (SortedMap <K, ? extends V> m) 
// fournit une vue non modifiable de m 

<T> 

SortedSet <T>unmodifiableSortedSet (SortedSet <T> e) 
// fournit une vue non modifiable de e 
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2 Versions anterieures au JDK 5.0 

2.1 Les interfaces 



Collection 

boolean 
boolean 

void 
boolean 

boolean 

boolean 

Iterator 

boolean 

boolean 

boolean 

int 

Object [ ] 
Object [ ] 

tableau 

List (Collection) 

void 
boolean 

Object 
int 

int 

Listlterator 
Listlterator 
Object 

Object 

List 



add (Object elem) 
addAII (Collection c) 

clear () 

contains (Object elem) 

containsAII (Collection c) 

isEmpty () 
iterator () 

remove (Object elem) 

removeAII (Collection c) 

retainAII (Collection c) 

size () 
toArray () 

toArray (Object[j a) 



// ajoute elem a la collection 

// ajoute tous les elements de c 
//a la collection 

//supprime tous les elements 

//true s/elem appartienta la collection 
//false sinon 

//true si tous les elements de c 

// appartiennent a la collection - false sinon 

//true si la collection est vide - false sinon 

// fournit un iterateur monodirectionnel 

//supprime elem s'il existe et renvoie 
//true - sinon renvoie false 

//supprime de la collection tous les 
// elements presents dans c 

// ne conserve dans la collection que 
//les elements presents dans c 

// fournit le nombre d'elements 

// fournit un tableau contenant une copie 
// des elements de la collection 

//si a est assez grand, y place une copie 
//des elements de la collection 
//si a est trop petit, cree un nouveau 

// fournit la reference au tableau utilise 



add (int index, Object elem) 
addAII (int index, Collection c) 

get (int index) 
indexOf (Object elem) 

lastlndexOf (Object elem) 

listlterator () 
listlterator (int index) 
remove (int index) 

set (int index, Object elem) 

subList (int debut, int fin) 



//ajoute elem a la position index 

//ajoute tous les elements de c 
//a partir de la position index 

// fournit I'element de rang index 

// fournit le rang du premier element 
//valante\em 

// fournit le rang du dernier element 
// valant elem 

// fournit un iterateur bidirectionnel 

//cree un iterateur, initialise a index 

//supprime I'objet de rang index et 
// en fournit la valeur 

// remplace /'element de rang index 
//par elem 

// fournit une vue d'une sous-liste 
// de la liste d'origine, constitute 
// des elements de rang debut a fin 
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Set (Collection) 

pas de methodes supplementaires par rapport a Collection 
SortedSet (Set - Collection) 



Map 



Comparator 


comparator () 


// fournit le comparateur prevu a la 
//construction s'il existe - null sinon 


Object 


first () 


// fournit le premier element 


SortedSet 


headSet (Object max) 


// fournit une vue de /'ensemble 
// des valeurs inferieures a max 


Object 


last () 


// fournit le dernier element 


SortedSet 


subSet (Object min, Object max) 


// fournit une vue de /'ensemble 
//des valeurs entre min (inclu) 
// et max (exclu) 


SortedSet 


tailSet (Object min) 


// fournit une vue de /'ensemble des 
// valeurs sup. ou egales a min 



void clear () 

boolean containsKey (Object cle) 

boolean containsValue (Oject valeur) 

set entrySet () 

Object get (Object cle) 

boolean isEmpty () 
sinon 

set keySet () 

Object put (Object cle, Object valeur) 

void putAII (Map m) 

Object remove (Object cle) 

int size () 

Collection values () 

SortedMap 

Comparator comparator () 

Object firstKey () 

SortedMap headMap (Object cleMax) 

Object LastKey () 



//supprime tous les elements 

//true si la cle appartient a la table 
//false sinon 

//true si valeur appartient a la table 
//false sinon 

// fournit une vue des "paires" de la 
// table, sous forme d'un ensemble 
// d' elements de type Map. Entry 

// fournit la valeur associee a cle 

// true si la table est vide - false 

// fournit une vue des cles de la table 

// ajoute (cle, valeur^ dans la table 

// ajoute tous les elements de m 

//supprime /'element de cle indiquee 

// fournit le nombre d'elements 

// fournit une vue des valeurs 
//de la table 



// fournit le comparateur prevu a la 
//construction s'il existe - null sinon 

// fournit la premiere cle si elle existe 
//null sinon 

// fournit une vue des elements de 
// cle inferieure a cleMax 

// fournit la derniere cle 



SortedMap subMap (Object cleMin, Object cleMax) //fournit une vue des 

//elements de cle sup. ou egale a cleMin ef inferieure a cleMax 

SortedMap tailMap (Object cleMin) //fournit une vue des elements 

//de cle sup. ou egale a cleMin 



Annexe G 



759 



Map. Entry 



Iterator 



Object 
Object 
Object 



boolean 

Object 

void 



getKey () // fournit la cle d'un element de type Map. Entry 

getValue () // fournit la valeur d'un element de type Map. Entry 

setValue (Object val) // remplace par val la valeur d'un element 

//de type Map. Entry 



hasNext () 
next () 
remove () 



Listlterator (Iterator) 



void 
boolean 

int 

object 
int 

void 



add (Object elem) 
hasPrevious () 

nextlndex () 

previous () 

previouslndex () 

set (Object elem) 



//true si la position courante designe un element 
// fournit /'element courant et avance I'iterateur 
//supprime /'element courant 



// ajoute elem a la position courante 

//true s'il existe un element precedant 
// la position courante 

// fournit le rang de /'element courant (celui qui 
// serait renvoye par un prochain appel de next,) 

// fournit /'element precedant la position 
//courante ety deplace I'iterateur 

// fournit le rang de /'element precedant /'element 
//courant (celui qui serait renvoye par un prochain 
//appel de previous,) 

//remplace /'element courant par elem 



2.2 Les classes implementant List 

Comme List derive de Collection, ces classes implemented aussi Collection. Les methodes 
prevues dans List et dans Collection ne sont pas rappelees ici. 

Vector (implements List) 



void 


addElement (Object elem) 


//ajoute elem a la collection 


int 


capacity () 


// fournit la capacite courante 


Object 


elementAt (int index) 


// fournit 1' element de rang index 


void 


ensureCapacity (int capMin) 


// ajuste la capacite a capMin 
// (si elle est inferieure) 


Object 


firstElement () 


// fournit le premier element 


int 


indexOf (Object elem, int index) 


// fournit le rang du premier element 
// egal a elem, a partir du rang index 



void insertElementAt (Object elem, int index) //ajoute elem avant I'element 

//de rang index 

Object lastElement () // fournit le dernier element du vecteur 

boolean offer (E elem) //ajoute elem en fin de liste 

E peek () // fournit le premier element de la liste 

// (sans le supprimer) 
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void 
boolean 

void 
void 

void 

void 



poll () // fournit le premier element de la liste, 

// en le supprimant 

//supprime tous les elements 

//supprime le premier element egal 
//a elem 

//supprime /'element de rang index 

// remplace par elem 
// /'element de rang index 

// modifie la taille du vecteur 
// (peut supprimer des elements) 

// ajuste la capacite du vecteur 
//a sa taille actuelle 

//construit un vecteur vide 

//construit un vecteur vide ay ant 
//la capacitelnitiale indiquee 

Vector (Collection <? extends E> c) //construit un vecteur forme 

//des elements de la collection c 

Vector (int capacitelnitiale, int increment) //construit un vecteur vide 
// ayant la capacitelnitiale indiquee et utilisera 
//la valeur increment lorsqu'il faudra en accroTtre la capacite 



removeAIIEIements () 
removeElement (Object elem) 

removeElementAt (int index) 
setElementAt (E elem, int index) 

setSize (int nouvelleTaille) 

trimToSize () 

Vector 0 

Vector (int capacitelnitiale) 



LinkedList (implements List) 



void 


addFirst (Object elem) 


// ajoute elem en debut de liste 


void 


addLast (Object elem) 


// ajoute elem en fin de liste 


Object 


getFirst () 


// fournit le premier element de la liste 
// s'il existe ('null sinon) 


Object 


getLast () 


// fournit le dernier element de la liste 
//s'il existe ('null sinon) 




LinkedList () 


// construit une liste vide 




LinkedList (Collection c) 


// construit une liste formee des elements 
//de la collection c 


Object 


removeFirst () 


//supprime le premier element de la liste 
// et en fournit la valeur ('null si liste vide) 


Object 


removeLast () 


//supprime le dernier element de la liste 
// et en fournit la valeur ('null si liste vide) 



ArrayList (implements List) 

ArrayList () 



ArrayList (int capacitelnitiale) 
ArrayList (Collection c) 



// construit un vecteur vide 

//construit un vecteur vide 
//de capacite mentionnee 

//construit un vecteur forme 
//des elements de c 



void 



void 



ensureCapacity (int capaciteMini) //ajuste la capacite a capaciteMini 

// ( si elle est inferieure) 

trimToSize () //ajuste la capacite du vecteur 

// a sa taille actuelle 
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2.3 Les classes implementant Set 

Comme Set et SortedSet derivent de Collection, ces classes implementent aussi Collection. 
Les methodes prevues dans Set et dans Collection ne sont pas rappelees ici. 

HashSet {implements Set) 

HashSet () // construit un ensemble vide 

HashSet (int capalnitiale) // construit un ensemble vide avec une 

// table de hachage de capalnitiale seaux 

HashSet (Collection c) //construit un ensemble forme des 

// elements de c 

HashSet (int capalnitiale, float fCharge) //construit un ensemble vide 
//avec une table de hachage de capalnitiale seaux 
// et un facteur de charge de f Charge 

TreeSet {implements SortedSet) 

TreeSet () // construit un ensemble vide 

TreeSet (Collection c) //construit un ensemble forme des 

// elements de c 

TreeSet (Comparator comp) //construit un ensemble vide 

//qui utilisera le comparateur comp pour ordonner ses elements 

TreeSet (SortedSet s) // construit un ensemble forme des 

// elements de s et utilisant le meme comparateur 

2.4 Les classes implementant Map 

Attention, ces classes n' implementent plus l'interface Collection, mais seulement l'interface 
Map ou son interface derivee SortedMap. Les methodes prevues dans Map et dans Sorted- 
Map ne sont pas rappelees ici. 

HashMap {implements Map) 

HashMap () //construit une table vide 

HashMap (int capalnitiale) //construit une table vide, avec une table 

//de hachage de capalnitiale seaux 

HashMap (Map m) //construit une table formee 

// des elements de m 

HashMap (int capalnitiale, float fCharge) //construit une table vide 

//avec une table de hachage de capalnitiale seaux 
// et un facteur de charge de fCharge 

TreeMap {implements SortedMap) 

TreeMap () // construit une table vide 

TreeMap (Comparator comp) // construit une table vide 

//qui utilisera le comparateur comp pour ordonner ses elements 

TreeMap (Map m) //construit une table formee 

// des elements de m 

TreeMap (SortedMap s) // construit une table formee des 

// elements de s et utilisant le meme comparateur 



2.5 Les algorithmes de la classe Collections 



Toutes ces methodes ont I'attribut static. 



int binarySearch (List liste, Object elem) 

// effectue une recherche de la valeure\em, en se basant sur 
// I'ordre induit par la methode compareTo des elements ou par 
// un comparateur ; fournit une valeur positive representant sa 
// position dans la collection, si elle existe ; fournit une valeur 
// negative indiquant ou elle pourrait s'inserer, si elle n'existe pas 

int binarySearch (List liste, Object elem, comparator comp) 

// meme chose que I'algorithme precedent, mais en se basant 

sur 

// I'ordre induit par le comparateur comp 

void copy (List but, List source) 

// recopie tous les elements de source a la meme position de but 
// (qui doit posseder au moins autant d'elements que source,) 

void fill (Liste liste, Object elem) 

// remplace tous les elements de la collection par elem 

Object max (Collection c) 

// fournit le plus grand element de la collection, en se basant sur 
//I'ordre induit par la methode compareTo ou par un comparateur 

Object max (Collection c, comparator comp) 

// meme chose que I'algorithme precedent, mais en se basant 

sur 

//I'ordre induit par le comparateur comp 

Object min (Collection c) 

// fournit le plus petit element de la collection, en se basant sur 
//I'ordre induit par la methode compareTo ou par un comparateur 

Object min (Collection c, comparator comp) 

// meme chose que I'algorithme precedent, mais en se basant 

sur 

// I'ordre induit par le comparateur comp 

List nCopies (int n, Object elem) 

// fournit une liste non modifiable, formee de n elements 
//de valeur elem 

void reverse (List liste) 

// inverse I'ordre (nature!) des elements de la collection 

Comparator reverseOrder () 

// fournit un objet comparateur inversant I'ordre induit sur la 
// collection par la methode compareTo des objets ou par un 
// comparateur 

void shuffle (List liste) 

// melange la collection, de maniere aleatoire 

Set singleton (Object elem) 

// fournit un ensemble non modifiable comportant le 
// seul element elem 

void sort (List liste) 

// trie la collection, en se basant sur I'ordre induit par la methode 
//compareTo de ses elements ou par un comparateur 
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void sort (List liste, comparator comp) 

// trie la collection, en se basant sur I'ordre induit par 
// le comparateur comp 

Collection synchronizedCollection (Collection c) 

// fournit une vue de c, dans laquelle les methodes peuvent etre 
// utilisees par plusieurs threads 

List synchronizedList (List I) 

// fournit une vue de I, dans laquelle les methodes peuvent etre 
// utilisees par plusieurs threads 

Map synchronizedMap (Map m) 

// fournit une vue de m, dans laquelle les methodes peuvent etre 
// utilisees par plusieurs threads 

Set synchronizedSet (Set e) 

// fournit une vue de e, dans laquelle les methodes peuvent etre 
// utilisees par plusieurs threads 

SortedMap synchronizedSortedMap (SortedMap m) 

// fournit une vue de m, dans laquelle les methodes peuvent etre 
// utilisees par plusieurs threads 

SortedSet synchronizedSortedSet (SortedSet e) 

// fournit une vue de e, dans laquelle les methodes peuvent etre 
// utilisees par plusieurs threads 

Collection unmodifiableCollection (Collection c) 

// fournit une vue non modifiable de c 

List unmodifiableList (List I) 

// fournit une vue non modifiable de I 

Map unmodifiableMap (Map m) 

// fournit une vue non modifiable de m 

Set unmodifiableSet (Set e) 

// fournit une vue non modifiable de e 

SortedMap unmodifiableSortedMap (SortedMap m) 

// fournit une vue non modifiable de m 

SortedSet unmodifiableSortedSet (SortedSet e) 

// fournit une vue non modifiable de e 
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Java 6 a introduit de nouvelles fonctionnalites permettant d'ameliorer la qualite des applica- 
tions a caractere professionnel et leur "integration au systeme". Nous vous proposons ici les 
plus importantes, a savoir : 

• la possibility d'incorporer une icone dans la barre des taches, 

• la classe Desktop qui permet de lancer automatiquement le navigateur par defaut, d'envoyer 
un e-mail ou de manipuler un fichier a l'aide de 1' application par defaut correspondante, 

• la classe Console qui ameliore le fonctionnement des applications ne disposant que d'une 
console. 

Par ailleurs, nous donnerons quelques informations permettant d'agir sur 1' aspect des compo- 
sants (Look and feel). 

1 Incorporation d'icones dans la barre 
des taches 

La plupart des environnements de programation disposent d'une "barre des taches" 1 conte- 
nant differentes "icones" indiquant la presence d'une application et fournissant eventuelle- 
ment quelques informations sur son deroulement. 



1. Le terme exact depend du systeme utilise : "barres des taches" sous Windows, "zone de notification" sous 
Gnome, "barre systeme" sous KDE... 
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Dorenavant, une application Java peut, elle-aussi, placer une icone dans la barre des taches du 
systeme, la modifier ou la supprimer. Cette icone pourra eventuellement disposer d'une bulle 
d' information et d'un menu contextuel. Toutefois, cette possibilite n'est disponible que dans 
certains environnements seulement. On peut s'en assurer en examinant la valeur de 
l'expression : 

SystemTray . isSupported ( ) 

Si tel est le cas, voici comment proceder pour ajouter une icone a la barre des taches : 

• Creation d'un objet de type Traylcon destine a la gestion de l'icone dans la barre des taches ; 
on fournira a son constructeur : 

- un objet de type Image representant l'icone elle-meme (on peut aussi creer un objet de 
type Imagelcon, voir le chapitre 18 "Textes et graphiques") et lui appliquer la methode 

get Image ; 

- eventuellement, un texte correspondant au message qu'on souhaite voir s'afficher 
quand l'utilisateur survole l'icone avec sa souris, 

- eventuellement, la reference a un menu contextuel Popup qui s'affichera classique- 
ment par un clic sur l'icone ; bien entendu, si Ton souhaite exploiter cette possibilite, 
il faudra doter ce menu des ecouteurs d'evenements appropries. 

Voici un exemple dans lequel nous creons une icone formee d'un carre rouge (figurant dans 
un fichier nomme rouge.gif, avec le message d'information : "Pour Info_Bulle Icone Rou- 

ge": 

Imagelcon iml = new Imagelcon ("rouge.gif") ; 
Image imagel = iml . getlmage ( ) ; 

Traylcon ticl = new Traylcon (imagel, "PourInfo_Bulle_Icone_Rouge") ; 

• Recuperation de la reference a 1' unique objet de type SystemTray representant la barre des 
taches elle-meme : 

SystemTray tray = SystemTray. getSystemTray () ; 

• Introduction du nouvel objet de type Traylcon dans la barre des taches avec la methode add : 

tray. add (ticl) ; 

On peut ajouter autant d'icones qu'on le souhaite a la barre des taches. On peut supprimer 
une icone donnee par appel de la methode remove. 

Voici un exemple de programme qui place tout d'abord une premiere icone obtenue a partir 
du fichier rouge.gif. Apres validation de l'utilisateur (frappe de "return"), le programme 
ajoute une seconde icone obtenue a partir du fichier vert.gif. Apres une nouvelle validation de 
l'utilisateur, le programme supprime la premiere icone de la barre des taches. Enfin, le pro- 
gramme s'interrompt apres une derniere validation. 
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import java.awt.* ; 
import javax. swing.* ; 
import java.io.* ; 
public class BarreDesTaches 

{ public static void main (String args[ ] ) throws AWTException, IOException 
{ if (SystemTray.isSupportedO ) System. out. println ("SystemTray OK") ; 

else { System. out. println ("SystemTray pas supporte") ; 
System. exit (-1) ; 

} 

Imagelcon iml = new Imagelcon ("rouge.gif") ; 
Image image 1 = iml. get Imaged ; 

Traylcon ticl = new Traylcon (imagel, "PourInfo_Bulle_Icone_Rouge") ; 
SystemTray tray = SystemTray . getSystemTray ( ) ; 
tray. add (ticl) ; 

Clavier. lireString () ; // pour provoquer une attente utilisateur 
Imagelcon im2 = new Imagelcon ("vert.gif") ; 
Image image2 = im2. get Image () ; 

Traylcon tic2 = new Traylcon (image2, "PourInfo_Bulle_Icone_Verte") ; 
tray. add (tic2) ; 

Clavier . lireString () ; // nouvelle attente 
tray. remove (ticl) ; // suppression premiere icone 
Clavier . lireString () ; // derniere attente 
} 

} 

Exemple d'ajout et de suppression d'icones dans la barre des tach.es 

2 La classe Desktop 

Cette classe offre les fonctionnalites suivantes : 

• lancement du navigateur par defaut a une adresse donnee, 

• envoi d'un e-mail, a Faide du gestionnaire par defaut, 

• ouverture, edition ou impression d'un fichier en lancant 1' application concernee. 

La encore, ces differentes possibilites n' existent pas dans tous les environnments et, de plus, 
un environnement donne peut n'en offrir qu'une partie. Pour savoir si on peut disposer de 
tout ou partie de ces fonctionnalites, on examinera la valeur de l'expression : 

Desktop . isDesktopSupported ( ) 
Si elle est vraie, on pourra instancier un objet de type Desktop, de cette fafon : 

Desktop bureau = Desktop. getDesktopO ; 
On s'assurera ensuite que l'une des fonctions evoquees est bien disponible, en examinant la 
valeur de l'expression : 

bureau . is Supported (Desktop .Action . XXXXX) 
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dans laquelle XXXXX designe Taction concernee, parmi : BROWSE (pour le navigateur), 
MAIL, OPEN, EDIT ou PRINT. 

Pour lancer le navigateur, on utilisera la methode browse a laquelle on fournira un argument 
de type correspondant a l'adresse de lapagequ'on souhaite consulter. La classe URI dis- 
pose d'un constructeur recevant simplement une adresse en argument, comme dans : 

URI adresseWeb = new URI ("http://www.editions-eyrolles.com") ; 

Pour envoyer un e-mail, on utilisera la methode mail a laquelle on communiquera YURI de 
l'utilisateur. 

Enfin, pour ouvrir, editer ou imprimer un fichier, on utilisera l'une des methodes open, edit 
ou print, a laquelle on fournira simplement un objet de type FILE representant le fichier con- 
cerne. 

Voici un exemple de schema de programme vous permettant de tester chacune de ces possibi- 
lity dans votre propre environnement (n'oubliez pas de le completer avec vos propres 
informations) : 

import java.awt.* ; // pour Desktop 
import java.io.* ; // pour IOException 
import java.net.*; // pour URI 
public class testDesktop 

{ public static void main (String! ] args) throws URISyntaxException, IOException 
{ if (Desktop. isDesktopSupportedO ) System. out. println ("Desktop supporte"); 

else { System. out. println ("Desktop non supporte") ; 
System. exit (-1) ; 

} 

// definitions des differentes informations a completer : 

// url, adresse e-mail, nom fichier (xxxxxx) et type (ttt) , message 

URI adresseWeb = new URI ("http: //www ") ; 

File fichier = new File ("xxxxxx. ttt") ; 

String message = "salut" ; 

URI uriMail= new URI (" ", message, null) ; 

Desktop bureau = Desktop. getDesktop () ; 

if (bureau. isSupported (Desktop. Action. BROWSE) ) 

( System. out. println ("BROWSE accepte") ; 

bureau. browse (adresseWeb) ; // peut declencher une IOException 

System. in. read () ; // pour creer une attente 

} 

if (bureau . isSupported (Desktop .Action . MAIL) ) 
{ System. out. println ("MAIL accepte") ; 
bureau. mail (uriMail) ; 

System. in. read () ; // pour creer une attente 

} 

if (bureau. isSupported (Desktop. Action. OPEN) ) 
{ System. out. println ("OPEN accepte") ; 
bureau. open (fichier) ; 

System. in. read () ; // pour creer une attente 

} 
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if (bureau . isSupported (Desktop. Action . PRINT) ) 
{ System. out. println ("PRINT accepte") ; 
bureau. print (fichier) ; 

System. in. read () ; // pour creer une attente 



Utilisation de la classe Desktop 




Remarqi 



lues 



1 Actuellement, le bureau de Java ne peut fonctionner qu'avec les applications par defaut. 
Par exemple, si dans votre environnement, un fichier texte s'ouvre avec le bloc -notes, 
vous ne pourrez pas Pouvrir en Java avec un autre editeur. Pour y parvenir, vous devrez au 
prealable modifier 1' editeur par defaut, par des commandes systeme appropriees. 

2 Le terme bureau (desktop) sera beaucoup plus explicite si vous presentez a l'utilisateur 
les diverses fonctionnalites evoquees, dans une bolte de dialogue munie des champs 
textes necessaires a la saisie des differentes informations (nom de fichier, adresses...) et 
de boutons permettant de lancer chacune des actions (connexion Internet, e-mail, 
ouverture...). 



Nous savons que, quelle que soit la maniere dont on lance une application Java (en ligne de 
commande ou depuis un EDI 1 ), on dispose toujours d'une "fenetre console", permettant 
d'effectuer a la fois des lectures et des affichages. Dans le premier cas, il s'agit de la fenetre 
dans laquelle on a entre la commande de lancement de l'application (Java ...) ; elle est geree 
par le systeme d' exploitation (DOS, Shell...). Dans le second cas, il s'agit d'une fenetre creee 
et geree par l'EDI. Cette difference de gestion se retrouve dans la facon dont sont pris en 
compte certains caracteres. Par exemple, les caracteres n'appartenant pas au code ASCII res- 
treint (dont font notamment partie les caracteres accentues) ne sont pas represented de la 
meme maniere sous DOS et sous Windows. 

La classe Console a ete introduite par JSE6 pour regler ces problemes et, en meme temps, 
offrir la possibilite d'entrer un mot de passe depuis la fenetre de lancement en mode com- 
mande. Plus precisement, lorsqu'une application est lancee en mode commande, il est possi- 
ble d'associer un objet de type Console a la fenetre de lancement et de confier a cet objet la 
gestion du dialogue avec l'utilisateur. Toutefois, la encore, cette possibilite n'est pas 



3 La 



classe Console 



1. Environnement de developpement integre. 
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necessairement disponible. Elle depend a la fois de Fenvironnement concerne et de la 
maniere dont il a ete configure. 

Pour creer cet objet associe a la fenetre de commande, on utilise la methode console de la 
classe System : 

Console cons = System. console () ; 

Elle nous fournit, soit la reference a l'objet en question si la fonctionnalite est disponible, soit 
la valeur null dans le cas contraire. 

A priori, cette classe Console ne dispose que d'un nombre restreint de methodes, parmi les- 
quelles on peut citer : 

• readLine qui lit une ligne au clavier dans un objet de type String, 

• readPassword fournit un tableau de caracteres contenant les caracteres lus au clavier, sans 
les afficher a l'ecran (la validation reste classique). 

Mais, il est facile de retrouver les possiblites habituelles de System.out en creant un objet de 
type PrintWriter associe a cette console, a Faide de la methode writer : 

PrintWriter wcon = cons .writer () ; // wcon = PrintWriter associe a la console 

Voici un petit programme illustrant ces possibilites : execute ici sous DOS, il lit un mot de 
passe (et il le reaffiche) ; il lit quelques caracteres (dont des caracteres nationaux) qu'il 
reaffiche, d'une part avec les methodes de la classe Console, d' autre part avec les mehodes de 
System.out ; on constate que les caracteres nationaux s'affichent convenablement dans le pre- 
mier cas, et pas dans le second. 



import j ava . io . * ; 
public class TestConsole 
{ public static void main (String args[ ] ) 
{ Console cons = System. console () ; 

if (cons == null) { System. out. println ("pas de console") ; // sur System.out 
System. exit (-1) ; 

} 

else System. out. println ("il y a une console") ; // sur System.out 

char pass [] = cons .readPassword () ; 

System. out. print ("mot de passe fourni : ") ; // echo password 

for (char c : pass) System. out. print (c) ; 
System . out . println ( ) ; 

PrintWriter wcon = cons .writer () ; // wcon = PrintWriter associe a la console 
wcon. println ("quelques caracteres a probleme sur console : eaec") ; 
System. out. println ("quelques caracteres a probleme sur out : eaec") ; 

wcon. println ("donnez une ligne de texte : ") ; 

String ligne = new String)) ; // pour lire une ligne au clavier 

ligne = cons . readLine ( ) ; // lecture cf une ligne sur console 

wcon. println ("on a lu :" + ligne + ":") ; // affichage sur console 

System. out. println ("on a lu :" + ligne + ":") ; // puis sur System.out 

} 

) 



Annexe H 



771 




Utilisation de la classe Console 

\^^~ Remarque 

La classe Console dispose, comme la classe PrintWriter de methodes d'impression for- 
matee printf et format. La encore, le resultat obtenu avec ces methodes appliquees a un 
objet de type Console sont plus satisfaisantes que les memes methodes appliquees a 
l'objet correspondant de type PrintWriter 

4 Action sur I'aspect des composants 

Avec swing, il est en fait possible de choisir I'aspect des composants s'affichant dans un con- 
teneur. Jusqu'ici, nous nous sommes contentes de la presentation par defaut. Mais il est pos- 
sible d'intervenir sur ce point, en demandant d'utiliser un modele d' aspect (nomme "look and 
feel") de son choix. 

Pour ce faire, on dispose d'une classe UIManager dont la methode getlnstalledLookAndFeels 
fournit un tableau d'objets de type LookAndFeellnfo correspondant chacun a un modele 
d' aspect : 

UIManager . LookAndFeellnfo laf[ ] = UIManager . getlnstalledLookAndFeels ( ) ; 

Pour utiliser un modele d' aspect donne, on fera appel a la methode setLookAndFeel, a 
laquelle on fournira la nom de la classe / representant le modele voulu : 

UIManager. setLookAndFeel ( (String) 1 .getClassName () ) ; 

Puis on demandera la mise a jour des composants du conteneur par 1' appel de updateCompo- 
nentTreeUI a laquelle on fournira le conteneur concerne (\c\fen) : 

SwingUtilities . updateComponentTreeUI ( fen) ; 
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Voici un schema de programme qui affiche une fenetre donnee, suivant chacun des modeles 
d' aspect existants (le contenu de la classe MaFenetre etant a definir). Le nom de classe de 
chaque modele trouve est affiche dans la fenetre console. Une attente permet a l'utilisateur 
d' observer le resultat avant de passer au modele suivant. 

class MaFenetre extends JFrame 
{ } 

public class EssaiLookAndFell 

{ public static void main (String args[ ] ) throws ClassNotFoundException, 

UnsupportedLookAndFeelException, InstantiationException, IllegalAccessException 
{ MaFenetre fen = new MaFenetre ( ) ; 
fen . setvisible (true) ; 

UIManager . LookAndFeellnf o lag ] = UIManager .getlnstalledLookAndFeels () ; 
for (UIManager. LookAndFeellnf o 1 :laf) 
{ System. out. println (1) ; 

UIManager . setLookAndFeel ( (String) l.getClassName () ) ; 

SwingUtilities . updateComponentTreeUI (fen) ; 

Clavier. lireStringO ; // pour une attente 




Canevas d 'exploration des differents "look an feel" 

A titre indicatif, le nom de chacun des modeles s'affichera sous cette forme : 

j avax . swing . UIManager$LookAndFeelInf c[ Metal j avax . swing . plaf . metal . MetalLookAndFeel] 
Si Ton convient de noter Tab le nom du tableau (javax.swing.UIManager$LookAndFeelInfo), 
voici la liste des differents modeles existants : 

Tafcf Metal j avax . swing . plaf . metal . MetalLookAndFeel] 

Tab[ CDE/Motif com. sun. java. swing. plaf .motif . Motif LookAndFeel] 

Tab[ Windows com . sun . j ava . swing . plaf . windows . WindowsLookAndFeel] 

Tab Windows Classic com. sun. java. swing. plaf .windows. WindowsClassicLookAndFeel] 
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de fin de ligne 29 
Comparable (interface) 603 
comparaison 

d'objets 119 
comparateur 604 
Comparator (interface) 605 
compareTo (Comparable) 603, 604 
compareTo (Object) 637 
compareTo (String) 256 
complement a deux 33 



complementaire 631 
Component (classe) 731 
composant 330, 730 

alignement d'un ~ 480 

contraintes de placement d'un ~ 
491 

dimensions d'un ~ 356, 480 

espacement de ~ 489 
composante RVB 512 
compteur 

de clics 456, 458 
concatenation (de chatnes) 249 
ConcurrentModificationException 

727 
console 9 

Console (classe) 769 
console (System) 770 
constante 

chaine 252 

couleur 512 

dans une interface 235 

entiere 34 

flottante 36 

symbolique, 42 
constructeur 110, 114, 192 

surdefinition de ~ 138 
Constructor (classe) 693 
Container (classe) 330, 732 
contains (Collection) 615 
contains (HashSet ou TreeSet) 630 
containsKey (HashMap ou 

TreeMap) 645 
contenu 330 

contexte graphique 348, 501 
continue (avec etiquette) 99 
continue (instruction) 97 
contrainte de placement 49 1 
contrat 1 17, 240 
CONTROL_MASK (InputEvent) 

466 
controleur 687 
conversion 

d'ajustement de type 51 

degradante 69 

des arguments 126 

du type char 53 
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forcee 66 

implicite 50, 220 

non degradante 69 

numerique 69 

par affectation 60 

par cast 68 

systematique 52 
coordonnees 

physiques 521 

utilisateur 521 
copie 

profonde 123 

superficielle 122 
cos (Math) 724 
couleur 512 

constante -512 
countToken (StringTokenizer) 562 
courbe de Bezier 521 
court-circuit 58 
covariance 205, 220 
CR 38, 556 
createGlue (Box) 490 
createHorizontalBox (BoxLayout) 
486 

createHorizontalStrut (Box) 490 
createNewFile (File) 566 
create VerticalBox (BoxLayout) 
486 

create VerticalStrut (Box) 490 
creation 

d'un fichier binaire en acces di- 
rect 552 
d'un fichier texte 557 
sequentielle d'un fichier binaire 
546 

D 

d'objets 119 
dans un JSP 672 
darker (Color) 513 
DatalnputStream(classe) 549, 552, 
572 

DataOutputStream (classe) 547, 

552, 571 
default (etiquette) 83 



DEFAULT_OPTION 
(JOptionPane) 400 
delete (File) 566 
demon 303 

depassement de capacite 49 
displacement de la souris 458 
Deque (interface) 639 
descendinglterator (ArrayDeque) 
640 

Desktop (classe) 767 
dessin 

a la volee 353 

forcer le ~ 350 
dessiner 346 

destroy (Applet) 535, 732 
destroy (mefhode) 663 
destroy (Thread) 305 
Dialog (police) 507 
Dialoglnput (police) 507 
Dimension (classe) 356 
dispose (JDialog) 410, 733 
DISPOSE_ON_CLOSE 322 
do... while (instruction) 86 
DO_NOTHING_ON_CLOSE 322 
Document (classe) 378 
DocumentEvent (classe) 741, 743 
DocumenfListener (interface) 378, 
741 

doGet (mefhode) 652 
Double (classe) 238 
double (type ~) 35 
Double.NaN 50 

Double.NEGATIVE_INFINITY 
50 

Double.POSITIVEJNFINITY 50 
draw Arc (Graphics) 518 
drawlmage (Graphics) 524 
drawLine (Graphics) 349, 514 
drawOval (Graphics) 514 
drawPolygon (Graphics) 516 
drawPolyLine (Graphics) 516 
drawRect (Graphics) 514 
drawRoundRect (Graphics) 515, 
520 

drawString (Graphics) 502 



droits d' acces 140, 164, 189, 206, 
717 

de paquetage 718 

E 

E (Math) 723 
ecouteur 323, 340 
EDIT 768 
edit (Desktop) 768 
effacement 584 
efficacite 612 

egalite d'elements d'une collection 

605 
EL 688 

elements de scipt 671 
ElementType 707 
ellipse 181, 204 
ellipse (trace de ~) 513 
EMBED (balise) 532 
EmptyStackException 727 
encapsulation 6, 142 
ensemble 627 

ensureCapacity (ArrayList) 626 
entier (type ~) 32 
entrySet (HashMap ou TreeMap) 
645 

Enumeration 627 
EOFException 554, 726 
equals (Object) 224, 605, 637 
equals (String) 255 
equalsIgnoreCase (String) 255 
erasure 584 
Error (classe) 294 
ERROR_MESSAGE 
(JOptionPane) 397 
etat 

d'un thread 314 
etiquette (composant) 371 
evenement 323, 329 

clavier 462 

de bas niveau 740 

fenetre 472 

focalisation 473 

souris 454 
exception 276 
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explicite 293 
implicite 293 

redeclenchement d'une ~ 289 

standard 293, 725 
Exception (classe) 276, 293 
exists (File) 567 
exit (System) 305 
exp (Math) 724 
expression 672 

constante 42, 62 

mixte 50 
Expression Langage 688 

F 

facteur de charge 634 
fenetre 10 

fermeture de ~ 473 

graphique 318 

parent 396, 405 
FF 38 
fichier 

a acces direct 573 

autorisation d'acces a un ~ 567 

binaire 546, 549, 552 

cache 567 

creation de ~ 566 

formate 556 

gestion de ~ 564 

indexe 554 

longueur d'un ~ 567 

pointage dans un ~ 554 

suppression de ~ 566 

test d'existence d'un ~ 567 

texte 556, 557, 559 
Field (classe) 693 
File (classe) 564 
File. separator 565 
FilelnputStream (classe) 549, 572 
FileNotFoundException 549, 726 
FileOutputStream (classe) 546, 570 
FileReader (classe) 560, 575 
FileWriter (classe) 557, 573 
fill (GridBagConstraints) 492 
fillArc (Graphics) 520 
fillPolygon (Graphics) 520 



fillRect (Graphics) 519 
fillRoundRect (Graphics) 520 
FilterlnputStream (classe) 572 
FilterOutputStream (classe) 570 
filtre 569 
final 42, 115, 227 
finalize 124 
finally 291 

first (CardLayout) 483 
first(TreeSet) 637 
Float (classe) 238 
float (type ~) 35 
Float.NaN 50 

Float.NEGATIVEJNFINITY 50 
Float.POSITIVE_INFINITY 50 
floor (Math) 724 
flottant (type ~) 34 
FlowLayout (classe) 331, 480 
FlowLayout.CENTER 480 
FlowLayout.LEFT 480 
FlowLayout.RIGHT 480 
flush (BufferedOutputStream) 571 
flush (OutputStream) 570 
flush (Writer) 573 
flux 545 

a acces direct 545, 552 

binaire 546, 549, 552 

binaire d' entree 571 

binaire de sortie 570 

d'entree 545 

de sortie 545 

sequentiel 545 

texte 556 

texte d'entree 574 

texte de sortie 573 
focalisation 473 
focus 334, 474 

perte de 374 
FocusAdapter (classe) 740 
FocusEvent (classe) 374, 474, 740, 
743 

focusGained (FocusListener) 374, 

474, 740 
FocusListener (interface) 374, 474, 

740 



focusLost (FocusListener) 374, 

474, 740 
fonction 

de hachage 633 
Font (classe) 506 
Font.BOLD 507 
Font.ITALIC 507 
Font.PLAIN 507, 509 
fonte 

choix de ~ 506 

courante 505 

famille de police d'une ~ 505 
hauteur d'une ~ 505 
interligne d'une ~ 505 
jambages d'une ~ 505, 506 
logique 506, 507 
physique 507, 509 
style d'une ~ 505, 507 
taille d'une ~ 505 

FontMetrics (classe) 502 

for 609 

for (instruction) 90 

for... each (instruction) 174, 180, 

609 
format 

d' image 524 

libre 27 
forme (remplissage de ~) 519 
formulaire HTML 659 

G 

G.U.I. 10 
genericite 602 
gestionnaire 

d'exception 277, 282 

de mise en forme 330, 477 

de securite 539 

personnalise 499 
get (ArrayList) 624 
get (HashMap ou TreeMap) 645 
get (LinkedList) 621 
GET (methode) 656, 670 
getAccelerator (JMenu) 735 
getAccelerator (JMenuItem) 736 
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getActionCommand 

(AbstractButton) 733 
getActionCommand (ActionEvent) 

335, 338, 421, 743 
getAnnotation 711 
getAnnotations 713 
getAscent (FontMetrics) 505 
getAvailableFontFamilyName 

(GraphicsEnvironment) 509 
getBackground (Component) 731 
getBounds (Component) 73 1 
getChar 700 
getClass (Class) 690 
getClickCount (MouseEvent) 456, 

742 

getCodeBase (Applet) 732 
getComponent (methode) 429, 

742, 743 
getConstructors 694 
getContentPane (JApplet) 533, 732 
getContentPane (JDialog) 733 
getContentPane (JFrame) 330, 732 
getContructor 699 
getDeclared Annotations 713 
getDeclaredConstructor 699 
getDeclaredConstructors 694 
getDeclaredField 699 
getDeclaredFields 694 
getDeclaredMethod 699 
getDeclaredMethods 694 
getDefaultToolkit (Toolkit) 356 
getDescent (FontMetrics) 505 
getDocument (DocumentEvent) 

743 

getDocument (JTextField) 734 
getDouble 700 
getFamily (Font) 509 
getField 699 
GetFields 694 

getFilePointer (RandomAccesFile) 
573 

getFirst (Deque) 640 
getFirst (LinkedList) 617 
getFont (Component) 731 
getFontMetrics (Component) 73 1 
getFontMetrics (Graphics) 502 



getFontName (Font) 509 
getForeground (Component) 731 
getFreeSpace (File) 568 
getGraphics (Component) 353, 731 
getGraphics (JComponent) 733 
getHeight (Component) 731 
getHeight (FontMetrics) 504, 505 
getHeight (Image) 527 
getlconHeight (Imagelcon) 525 
getlconWidth (Imagelcon) 525 
getlmage (Applet) 732 
getlmage (Toolkit, Applet) 527 
getlnputStream (Socket) 576 
getlnstalledLookAndFeels 

(UIManager) 771 
getlnt 700 

getKeyChar (KeyEvent) 463, 742 
getKeyCode (KeyEvent) 463, 742 
getKeyStroke (Keystroke) 430, 
468 

getKeyText (KeyEvent) 464, 742 
getLast (Deque) 640 
getLast (LinkedList) 617 
getLeading (FontMetrics) 505 
getLocalGraphicsEnvironment 

(GraphicsEnvironment) 509 
getMaxAscent (FontMetrics) 506 
getMaxDescent (FontMetrics) 506 
getMaximumSize (JComponent) 

359, 733 
getMenu (JMenuBar) 735 
getMessage (Exception) 283 
getMethod 699 
getMethods 694 
getMinimumSize (JComponent) 

359, 733 
getModifiers 696, 697 
getModifiers (ActionEvent) 743 
getModifiers (KeyEvent) 466, 742 
getModifiers (MouseEvent) 456, 

742 
getName 694 
getName (Class) 692 
getName (File) 567 
getName (Font) 509 
getParameter (Applet) 732 



gefParameterTypes 697 
getPoint (MouseEvent) 742 
getPreferredSize (JComponent) 

359, 733 
getRetumType 697 
getScreenSize (Toolkit) 356 
getSelectedlndex (JComboBox) 

387, 735 
getSelectedlndex (JList) 734 
getSelectedlndices (JList) 734 
getSelectedltem (JComboBox) 

387, 735 
getSelectedValue (JList) 381, 734 
getSelectedValues (JList) 381, 734 
getSize (Component) 73 1 
getSource (methode) 335, 336, 

421, 429, 742, 743 
getStateChanged (ItemEvent) 743 
getSystemTray (SystemTray) 766 
getText (AbstractButton) 733 
getText (JTextField) 734 
getToolkit (Component) 73 1 
getToolkit (JFrame) 732 
getTotalSpace (File) 568 
getType 696 

getUsableSpace (File) 568 
getValue (AbstractAction) 443, 
444 

getValuelsAdjusting (JList) 382, 
734 

getValuelsAdjusting 

(ListSelectionEvent) 743 
getWidth (Component) 731 
getWidth (Image) 527 
getWindow (WindowEvent) 743 
getWriter (methode) 653 
getX (Component) 731 
getX (MouseEvent) 326, 454, 742 
getY (Component) 731 
getY (MouseEvent) 326, 454, 742 
GIF 524 

glisser de souris 460 
glue 490 

Graphics (classe) 348 
Graphics2D (classe) 521 
GraphicsEnvironment (classe) 509 
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gras 507 

GridBagConstraints (classe) 491 
GridBagConstraints.BOTH 492 
GridBagConstraints.HORIZONTA 
L 492 

GridBagConstraints.NONE 492 
GridBagConstraints.VERTICAL 
492 

GridBagLayout (classe) 491 
gridheight (GridBagConstraints) 
492 

GridLayout (classe) 485 
gridwidth (GridBagConstraints) 
492 

gridx (GridBagConstraints) 492 
gridy (GridBagConstraints) 492 
groupe 

de threads 303 

H 

hachage 628, 633 
hasFocus (Component) 731 
hashCode (Object) 635 
HashMap (classe) 644 
HashSet (classe) 627, 633 
HashTable (classe) 627 
hasNext (Iterator) 607, 617 
hasPrevious (Listlterator) 610, 617 
hauteur 

d'une fonte 505 
height (Dimension) 356 
HEIGHT (paramerre) 530 
heritage 7, 186 

et interface 242 

et programmation generique 593 

multiple 242 
HIDE_ON_CLOSE 322 
hote 577 
HT 38 

HTML 529, 530, 652 
HTTP 657 

HttpRequest (classe) 652 
HttpServlet (classe) 652 
HttpServletResponse (classe) 652 



I 

identificateur 25 
identification 

de bouton 456 

de touche 463 
IEEE 49 

IEEEremainder (Math) 724 
if (instruction) 78 
IllegalAccessException 725 
IllegalArgumentException 700, 
726 

IllegalComponentStateException 
727 

IllegalMonitorStateException 726 
IllegalStateException 726, 727 
IllegalThreadStateException 298, 

726 
image 524 

affichage d'une ~ 524 
chargement d'une ~ 524, 525, 
527 

dimension d'une ~ 525 

format d'~ 524 
Imagelcon (classe) 524 
imageUpdate (Component) 73 1 
imageUpdate (Observer) 527 
imbrication 

de if 80 
implementation 

d'une classe 117 
import 162 
in 564 

include (balise) 686 
index 554 

indexOf (ArrayList) 626 
indexOf (LinkedList) 622 
indexOf (String) 253 
IndexOutOfBoundsException 726 
Infinity 50, 56 

INFORMATION_MESSAGE 

(JOptionPane) 397 
init (Applet) 533, 732 
init (methode) 663 
initialisation 

d'objet derive 192, 197 



d'un for 92 

de champ de classe 134 
de reference 121 
de tableau 169 
de tableau a plusieurs indices 
178 

de variable 40, 42 

explicite 197 

explicite d'un objet 113 

par defaut 197 

statique (bloc d'~) 134 
initialiseur 170, 178 
InputEvent (classe) 456 
InpufEvent.BUTTONlJVIASK 
456 

InputEvent.BUTTON2_MASK 
456 

InputEvent.BUTTON3_MASK 
456 

InputStream (classe) 549, 572 
InputStreamReader (classe) 564, 

575, 721 
insert (JMenu) 735 
insert (JMenu, JPopupMenu) 436 
insert (JPopupMenu) 736 
insert (StringBuffer) 265 
insertltemAt (JComboBox) 389, 

735 

insertSeparator (JMenu) 735 
insertUpdate (DocumentListener) 

378, 741 
InstantiationException 725 
instruction 

simple 24 

structuree 25 
int (type ~) 33 
Integer (classe) 238 
Integer.MAX_ VALUE 33 
Integer.MIN_VALUE 33 
interblocage 309 
interface 231 

console 9, 317 

definition d'une ~ 232 

derivation d'une ~ 235 

et classe derivee 234 

et constantes 235 
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et heritage 242 
et polymorphisme 233 
graphique 9, 317 
implementation d'une ~ 232 
interligne 505 

interrupted (Thread) 301, 303 
InterruptedException 301, 725 
InterruptedlOException 726 
interruption 

d'un thread 301 
intersection 631 
intranet 539 
introspection 689, 690 

des annotations 711 
invalidate (Component) 731 
InvalidClassException 726 
InvalidObjectException 726 
InvalidThreadStateException 303 
IOException 548, 554, 721, 726 
isAltDown (KeyEvent) 466, 467, 
742 

isAltDown (MouseEvent) 458, 742 
isAltGraphDown (KeyEvent) 466, 
742 

isAltGraphDown (MouseEvent) 
742 

is AnnotationPresent 711 
isControlDown (KeyEvent) 466, 

467, 742 
isControlDown (MouseEvent) 458, 

742 

isDesktopSupported (Desktop) 767 
isDirectory (File) 567 
isEmpty 615 

isEnabled (Component) 343, 731 
isFile (File) 567 
isFloatable (JToolBar) 737 
isFocusTraversable (Component) 

474, 731 
isHidden (File) 567 
islnterrupted (Thread) 303 
isMetaDown (KeyEvent) 466, 743 
isMetaDown (MouseEvent) 458, 

742 

isPopupTrigger (MouseEvent) 427, 
456, 742 



isSelected (AbstractButton) 363, 

367, 424, 733 
isSelected (JMenu) 735 
isShiftDown (KeyEvent) 466, 743 
isShiftDown (MouseEvent) 458, 

742 

isSupported (SystemTray) 766 
isTemporary (FocusEvent) 474, 
743 

isVisible (Component) 731 
italique 507 

ItemEvent (classe) 424, 741, 743 
ItemListener (interface) 362, 387, 
741 

itemStateChanged (ItemListener) 

362, 387, 424, 741 
iterateur 606 

bi-directionnel 609 

mono-directionnel 606 
Iterator (interface) 606 

J 

jambage 

ascendant 505 

ascendant maximum 506 

descendant 505 

descendant maximum 506 
JApplet (classe) 530, 533, 732 
java (commande) 16 
java.awt 332 
java.awt.event 325 
java.util 601 
JavaBean 679 

portee d'~ 684 
javac (commande) 16 
javax. swing 325 
JButton (classe) 330, 734 
JCheckBox (classe) 362, 734 
JCheckBoxMenuItem (classe) 423, 
736 

JComboBox (classe) 386, 735 
JComponent (classe) 733 
JDialog (classe) 405, 407, 733 
JDK 16 

JFrame (classe) 318, 732 



JLabel (classe) 371, 734 
JList (classe) 380, 734 
JMenu (classe) 420, 735 
JMenuBar (classe) 420, 735 
JMenuItem (classe) 420, 426, 736 
joker 597 

contraint 598 

simple 597 
JOptionPane (classe) 395, 398, 

401, 403 
JPanel (classe) 347, 733 
JPEG 524 

JPopupMenu (classe) 426, 736 
JPopupMenuEvent (classe) 429 
JRadioButton (classe) 365, 734 
JRadioButtonMenuItem (classe) 

423, 736 
JScrollPane (classe) 510, 737 
JSF 688 
JSP 651, 668 

chainage de ~ 686 

composition de ~ 686 

de calcul de factorielles 677 

execution de ~ 669 

inclusion dynamique de ~ 687 

inclusion statique de ~ 686 

JavaBean 679 

parametres 669 

jsp 

forward (balise) 686 
include (balise) 687 
JSTL 688 

JTextField (classe) 373, 734 
JToolBar (classe) 445, 737 

K 

Key Adapter (classe) 740 
KeyEvent (classe) 740, 742 
KeyListener (interface) 462, 740 
keyPressed (KeyListener) 463, 

467, 740 
key Released (KeyListener) 463, 

740 

keySet (HashMap ou TreeMap) 646 
Keystroke (classse) 430 
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key Typed (KeyListener) 463, 740 

L 

last (CardLayout) 483 
last (TreeSet) 637 
lastlndexOf (ArrayList) 626 
lastlndexOf (LinkedList) 622 
lastlndexOf (String) 253 
layoutContainer (LayoutManager) 
499 

LayoutManager (interface) 499 
lecture 

au clavier 21 

d'un fichier texte 559 

formatee 561 
length 173 
length (File) 567 
length (RandomAccesFile) 555, 
573 

length (String) 248 
LF 38, 556 

ligature dynamique 220 
ligne (trace de ~) 513 
ligne brisee (trace de ~) 513 
LinkedList (classe) 617, 639 
lireDouble (Clavier) 21, 720 
lireFloat (Clavier) 719 
lirelnt (Clavier) 21, 720 
lireString (Clavier) 719 
list (File) 568 
List (interface) 616 
liste 

sequentielle d'un fichier binaire 
549 

liste chainee 617 
listFiles (File) 568 
Listlterator (interface) 609, 617 
ListModel (classe) 383 
ListSelectionEvent (classe) 741, 
743 

ListSelectionListener (interface) 

382, 741 
localhost 655 
log (Math) 724 
Long (classe) 238 



long (type ~) 33 
Long.MAXJVALUE 33 
Long.MIN_ VALUE 33 
LookAndFeellnfo (UIManager) 
771 

M 

machine virtuelle 5, 12, 539 

MAIL 768 

mail (Desktop) 768 

Map. Entry (interface) 645 

Math (classe) 133, 723 

max (Collections) 641 

max (Math) 724 

MAX.PRIORITY (Thread) 316 

MediaTracker (classe) 527 

melange 642 

menu 420 

accelerateur de ~ 429 

activation d'un ~ 435 

barre de ~ 420 

deroulant 420 

dynamique 435 

option de ~ 420 

raccourci clavier d'un ~ 429 

surgissant 426 
menuCanceled (MenuListener) 

423, 741 
menuDeselected (MenuListener) 

423, 741 
MenuEvent (classe) 423, 741, 743 
MenuListener (interface) 423, 741 
menuSelected (MenuListener) 423, 
741 

META_MASK (InputEvent) 466 
meta-annotation 705 
Method (classe) 693 
mefhode 103 

bridge 597 

d'acces 118 

d' alteration 118 

de classe 129 

finale 227 

fonction 125 

generique 588 



recursivite de ~ 150 

surdefinition de ~ 135 

synchronisee 305 

typologie des -118 
MIME (type) 654 
min (Collections) 641 
min (Math) 724 
MIN.PRIORITY (Thread) 316 
minimumLayoutSize 

(LayoutManager) 499 
MisssingResourceException 727 
mkdir (File) 567 
mkdirs (File) 567 
modale (boite ~) 405 
mode 

de dessin 521 
Modele Vue Controleur 687 
modele-vue-controleur 378 
Modifier (classe) 696, 697 
Monospaced (police) 507 
more (commande Unix) 556 
mot cle 26 
Motif 1 1 

MouseAdapter (classe) 327, 740 
mouseClicked (MouseListener) 

323, 454, 740 
mouseDragged (MouseListener) 

740 

mouseDragged 

(MouseMotionListener) 459, 460 
mouseEntered (MouseEvent) 458 
mouseEntered (MouseListener) 

323, 740 
MouseEvent (classe) 326, 427, 

459, 740 
mouseExited (MouseListener) 323, 

458, 740 
MouseListener (interface) 323, 

454, 740 
MouseMotionAdapter (classe) 740 
MouseMotionListener (interface) 

459, 740 
mouseMoved 

(MouseMotionListener) 459, 740 
mousePressed (MouseListener) 
323, 454, 740 
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mouseReleased (MouseEvent) 427, 
454 

mouseReleased (MouseListener) 

323, 740 
MULTIPLE_INTERVAL_SELEC 

TION 380 

N 

NaN 50, 56 

NavigableSet (interface) 616, 638 
Negative Array SizeException 293, 

726 
new 105, 169 
nexlnt (Scanner) 721 
next (CardLayout) 483 
next (Iterator) 607, 617 
nextDouble (Scanner) 721 
nextFloat (Scanner) 721 
nextToken (StringTokenizer) 562 
nio (API) 548 

NO_OPTTON (JOptionPane) 399, 
400 

NORM. PRIORITY (Thread) 316 
NoSuchConstructorException 700 
NoSuchElementException 727 
NoSuchFieldException 725 
NoSuchMethodException 700, 725 
NotActiveException 726 
notation 

decimale 36 

exponentielle 36 
notification 310 
notify (Object) 310 
notify All (Object) 310, 315 
NotSerializabeException 726 
null 603 

NullPointerException 726 
NumberFormatException 262, 726 
numero de port 655 

o 

OBJECT (balise) 532 
Object (classe) 222 
ObjectStreamException 726 
objet 



en argument 142 

fonction 605 

membre 152 
observateur 527 
Observer (interface) 527 
octet 

ordre 551 
offer (Queue) 639 
offerFirst (Deque) 640 
offerLast (Deque) 640 
OK_CANCEL_OPTION 

(JOptionPane) 400 
OK_OPTION (JOptionPane) 400 
OPEN 768 
open (Desktop) 768 
operateur 

- 64 

! 57 

!= 55, 254 
& 57, 71 
&& 57 
&= 66 
*= 66 
+= 66, 251 
/= 66 
< 55 
« 71 
«= 66 
<= 55 
-= 66 
= 59 

== 55, 254 
> 55 
>= 55 
» 71 
»= 66 
»> 71 
»>= 66 
?: 75 
A 57, 71 
A = 66 

I 57, 71 
1= 66 

II 57 
~ 71 

a court-circuit 58 



arithmetique 47 

associativite d'un ~ 48 

binaire 47 

bit a bit 72 

conditionnel 74 

d' affectation elargie 65 

d' incrementation 63 

de decalage 73 

de decrementation 63 

de manipulation de bits 7 1 

logique 57 

priorite des ~ 48 

relationnel 54 

unaire 47 
option 

activation d'une ~ 435 

bouton radio 423 

case a cocher 423 

composition d'~ 433 

de menu 420 
OptionalDataException 726 
ordre 

des elements d'une collection 
603 

des octets 551 
origine 

changement d'~ 514 
out 559 

OutputStream (classe) 546, 570 
OutputStreamWriter (classe) 573 
ovale (trace de ~) 513 

P 

package 17, 161 
paint (Component) 731 
paintBorder (JComponent) 733 
paintChildren (JComponent) 733 
paintComponent (JComponent) 

348, 502, 733 
paire 645 
panneau 347 

de defilement 510 
paquetage 17, 161 

standard 163 
PARAM (balise) 537 
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parametre 
de type 580 

de type (limitations) 591 
parametres (d'une annotation) 703 
parametres (d'une servlet) 656 
parametres d'un JSP 669 
parseByte (Byte) 261 
parseDouble (Double) 262 
parseFloat (Float) 262 
parselnt (Integer) 261 
parseLong (Long) 262 
parseShort (Short) 261 
peek (Queue) 639 
peekFirst (Deque) 640 
peekLast (Deque) 640 
PI (Math) 723 
pisteur de medias 527 
PLAIN_MESSAGE (JOptionPane) 

397 
pointage 

dans un fichier 554 
police 505 
poll (Queue) 639 
pollFirst (Deque) 640 
pollLast (Deque) 640 
polygone (trace de ~) 513 
polymorphisme 8, 209, 596 

et redefinition 217 

et surdefinition 217 

limites du ~ 221 

regies generales 219 
PopuMenuEvent (classe) 743 
PopupMenu Listener (interface) 
742 

popupMenuCanceled 

(PopupMenuListener) 429, 742 
PopupMenuEvent (classe) 742 
PopupMenuListener (interface) 429 
popupMenuWillBecomelnvisible 

(PopupMenuListener) 429, 742 
popupMenuWillBecome Visible 

(PopupMenuListener) 429, 742 
port 576 
portee 

d'un JavaBean 684 
POST (methode) 656, 661, 670 



pow (Math) 724 

pr (commande Unix) 556 

preferredLayoutSize 

(LayoutManager) 499 
previous (CardLayout) 483 
previous (Listlterator) 610, 617 
PRINT 768 
print 15, 558, 574 
print (Desktop) 768 
Printer (classe) 556 
printf 16 

println 15, 247, 558, 574 
PrintStream (classe) 559 
PrintWriter (classe) 558, 574 
priorite 48 

d'un thread 315 
PriorityQueue (classe) 639 
private 103, 164, 718 
processus 295 
programmation 

evenementielle 10 

generique 579 

orientee objet 6 
promotion numerique 5 1 
proprietes de declenchement 686 
proprietes liees 686 
protected 225, 718 
public 103, 164, 717, 718 
put (HashMap ou TreeMap) 645 

Q 

QUESTION_MESSAGE 

(JOptionPane) 397 
Queue (interface) 616, 638 

R 

raccourci clavier 429 
ramassse-miettes 124 
random (Math) 724 
RandomAccessFile (classe) 552, 
573 

read (InputStream) 572 
read (Reader) 575 
readBoolean (DatalnputStream) 
572 



readBoolean (RandomAccesFile) 
573 

readByte (DatalnputStream) 572 
readByte (RandomAccesFile) 573 
readChar (DatalnputStream) 572 
readChar (RandomAccesFile) 573 
readDouble (DatalnputStream) 572 
readDouble (RandomAccesFile) 
573 

Reader (classe) 556, 575 
readFloat (DatalnputStream) 572 
readFloat (RandomAccesFile) 573 
readlnt (DatalnputStream) 549, 
572 

readlnt (RandomAccesFile) 573 
readLine (BufferedReader) 560, 
575 

readLine (Console) 770 
readLong (DatalnputStream) 572 
readLong (RandomAccesFile) 573 
readPassword (Console) 770 
readShort (DatalnputStream) 572 
readShort (RandomAccesFile) 573 
rectangle (trace de ~) 513 
recursivite 150 
redeclenchement 

d'une exception 289 
redefinition 199 

contraintes 204 

et derivations successives 202 

et droits d'acces 206 

et polymorphisme 217 

et surdefinition 203 

regies generales 207 
reference 

nulle 121 
reflexion 689 
registerKeyboardAction 

(JComponent) 468 
relation 

entre classes 241 
remove 732 
remove (ArrayList) 623 
remove (Collection) 618 
remove (HashMap ou TreeMap) 
645 
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remove (Iterator) 608, 617, 629, 
630 

remove (JMenu) 735 
remove (JMenu, JPopupMenu) 436 
remove (JPopupMenu) 736 
remove (JToolBar) 737 
remove (LinkedList) 621 
remove (Listlterator) 618 
remove All (Collection) 614 
removeAll (HashSet ou TreeSet) 
631 

removeAll (JMenu) 735 
removeAUItems (JComboBox) 735 
removeFirst (Deque) 640 
removeFirst (LinkedList) 618 
removeFirstOccurence 

(ArrayDeque) 640 
removeltem (JComboBox) 389, 

735 

removeltemAt (JComboBox) 735 
removeLast (Deque) 640 
removeLast (LinkedList) 618 
removeLastOccurence 

(An'ayDeque) 640 
removeLayoutComponent 

(LayoutManager) 499 
removeRange (ArrayList) 624 
removeUpdate (DocumentListener) 

378, 741 
repaint (JComponent) 35 1 
repertoire 564 

creation de ~ 567 
replace (String) 257 
replace (StringBuffer) 265 
request 669 

requestFocus (JComponent) 474 
resize (Applet) 732 
retain All (Collection) 614 
retainAll (HashSet ou TreeSet) 631 
RetentionPolicy 706 
retour arriere 38 
retour chariot 38 
reunion 631 

revalidate (JComponent) 357, 374, 
733 

reverseOrder (Collections) 643 



rint (Math) 724 
romain 507 
round (Math) 724 
run (Runnable) 298 
run (Thread) 296 
Runnable (interface) 298 
RunTimeException 726, 727 
RVB (composantes ~) 512 

s 

SansSerif (police) 507 
saut 

de ligne 38 

de page 38 
Scanner 721 
script 671 
scriptlet 668, 672 
seau 634 
securite 539 

SecurityException 539, 726 
seek (RandomAccesFile) 552, 573 
segment de droite (trace de ~) 513 
selection 

de zone 460 
separateur 27 
Serializable 686 
Serif (police) 507 
ServerSocket (classe) 576 
serveur 577 
servlet 651 

cycle de vie 663 

de calcul de factorielles 665 

parametres 656 
set (ArrayList) 624 
Set (interface) 616 
set (LinkedList) 622 
set (Listlterator) 611, 617 
setAccelerator (JMenu) 735 
setAccelerator (JMenuItem) 430, 
736 

setAccessible (Field) 701 
setActionCommand 

(AbstractButton) 421, 733 
setBackground (Component) 347, 

371, 731 



setBorder (JComponent) 370, 733 
setBounds (Component) 73 1 
setBounds (JFrame) 321 
setChar 700 

setCharAt (StringBuffer) 265 
setColor (Graphics) 506 
setColumns (JTextField) 734 
setContentPane (JFrame) 732 
setCursor (Component) 73 1 
setDefaultCloseOperation 

(JDialog) 733 
setDefaultCloseOperation (JFrame) 

322, 732 
setDouble 700 

setEditable (JComboBox) 386, 735 
setEditable (JTextField) 374, 734 
setEnabled (AbstractButton) 733 
setEnabled (Component) 343, 435, 

444, 731 
setEnabled (JMenu) 735 
setExecutable (File) 568 
setFloatable (JToolBar) 446, 737 
setFont (Component) 73 1 
setFont (Graphics) 506 
setForeground (Component) 731 
setHgap (methode) 478, 481 
setlnt 700 

setJMenuBar (JApplet) 732 
setJMenuBar (JDialog) 733 
setJMenuBar (JFrame) 732 
setLayout (Container) 331, 478, 

499, 732 
setLayout (JApplet) 732 
setLayout (JDialog) 733 
setLayout (JFrame) 732 
setLookAndFeel (UIManager) 77 1 
setMaximumRowCount 

(JComboBox) 386 
setMaximumSize (JComponent) 

733 

setMinimumSize (JComponent) 
733 

setMnemonic (AbstractButton) 

430, 431, 734 
setPaintMode (Graphics) 522 
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setPreferredSize (JComponent) 

357, 480, 733 
setPriority (Thread) 315 
setReadable (File) 567 
setReadOnly (File) 567 
setSelected (AbstractButton) 363, 

367, 734 
setSelected (JMenu) 735 
setSelectedlndex (JComboBox) 

386, 735 
setSelectedlndex (JList) 380, 734, 

735 

setSelectedlndices (JList) 735 
setSelectionMode (JList) 380, 735 
setSize (Component) 73 1 
setSize (JFrame) 318 
setText (AbstractButton) 734 
setText (JComponent) 371 
setText (JLabel) 734 
setText (JTextField) 734 
setTitle (JDialog) 733 
setTitle (JFrame) 318, 732 
setToolTipText (JComponent) 432, 

444, 733 
setVgap (methode) 478, 481 
set Visible (Component) 332, 731 
setVisible (JDialog) 406, 409 
set Visible (JFrame) 318 
setVisible (JPopupMenu) 736 
setVisibleRowCount (JList) 381, 

735 

setWriteble (File) 568 
setXORMode (Graphics) 521 
SHIFT_MASK (InputEvent) 466 
Short (classe) 238 
short (type ~) 33 
Short.MAX_ VALUE 33 
Short.MINVALUE 33 
show (CardLayout) 483 
show (JDialog) 733 
show (JPopupMenu) 427, 736 



showConfirmDialog (JOptionPane) 
398 

showInputDialog (JOptionPane) 

401, 403 
showMessageDialog 

(JOptionPane) 395 
shuffle 642 
sin (Math) 724 

SINGLE_INTERVAL_SELECTIO 
N 380 

SINGLE_SELECTION 380 

size (ByteArrayOutputStream) 571 

skip (InputStream) 572 

skip (Reader) 575 

sleep (Thread) 297, 315 

socket 576 

Socket (classe) 577 

sort (Collections) 642 

SortedSet (interface) 616 

souris 

deplacement 458 

glisser de ~ 460 
sqrt (Math) 724 
Stack (classe) 627 
start (Applet) 535, 732 
start (Thread) 296 
static 130, 134 
stop (Applet) 535, 732 
StreamCorruptedException 726 
String (classe) 246 
StringBuffer (classe) 265 
StringlndexOutOfBoundsExceptio 
n 726 

StringTokenizer (classe) 561 
stringWidth (FontMetrics) 502 
structure 

d'un programme Java 14 
strut 490 
style 

de fonte 507 
style (d'une fonte) 505 



substring (String) 257 
suivi de session 684 
super 193, 221 
surdefinition 202 

de constructeur 138 

de methode 135 

et heritage 202 

et polymorphisme 217 

et redefinition 203 

regies generales 137, 183, 207 
switch (instruction) 8 1 
SyncFailedException 726 
synchronized 305 
synchronized (instruction) 309 
synchronizedCollection 

(Collections) 650 
System 16 
systeme 

d' execution Java 12 

T 

table associative 644 
table de hachage 633 
tableau 167, 226 

a plusieurs indices 176 

creation de ~ 169 

d'objets 173 

de caracteres et chaine 263 

de chaines 258 

de tableaux 176 

declaration de ~ 168 

en argument 175 

utilisation d'un ~ 170 
tabulation 38 
tache 295 

taille (d'une fonte) 505 
tampon 548, 559 
tan (Math) 724 
TCP/IP 575 
telnet 575 
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texte 502 

position du ~ 502 
this 148 

thread 295, 320 

bloque 315 

demon 303 

en sommeil 315 

etats d'~ 314 

groupe de ~ 303 

interruption d'~ 301 

pret 314 

principal 298 

priorite 315 

utilisateur 303 
Thread (classe) 296 
ThreadGroup (classe) 303 
throw 276, 282 
Throwable (classe) 294 
throws 288 

to Array (Collection) 615 
toCharArray (String) 264 
toDegrees (Math) 724 
tokens 561 

toLowerCase (String) 258 

Toolkit (classe) 356 

TooManyListenersException 727 

toRadians (Math) 724 

toString (Class) 692 

toString (Collection) 615 

toString (Field) 697 

toString (Method, Constructor) 699 

toString (Object) 223 

touche 

identification de ~ 463 

modificatrice 430, 466 

virtuelle 430, 463 
toUpperCase (String) 258 
transformation geometrique 521 
translate (Graphics) 514 
transmission 

par adresse 141 

par reference 144 

par valeur 141 
Traylcon (classe) 766 
TreeMap (classe) 644 
TreeSet (classe) 627, 637 



tri 642 

trim (String) 258 
trimToSize (ArrayList) 626 
try 277 
type 31 

booleen 40 

brut 584 

byte 33 

caractere 37 

double 35 

entier 32 

float 35 

flottant 34 

int 33 

long 33 

primitif 32 

short 33 
type (commande) 556 

u 

UIManager (classe) 77 1 
Unicode 30, 37, 556 
unite d'encapsulation 142 
unmodifiableCollection 

(Collections) 650 
UnsupportedEncodingException 

726 

UnsupportedOperationException 
726 

update (Component) 73 1 
update (JDialog) 733 
update (JFrame) 732 
updateComponentTreeUI 

(UIManager) 771 
URI (classe) 768 
URL 526, 532, 652 
UTFDataFormatException 726 
Utilisation 105 

V 

valeur 644 
de retour 147 
de retour covariante 205 
initiale 40 
nulle 113 



validate (Component) 357, 374, 
731 

value (parametre) 704 
valueChanged 

(ListSelectionListener) 382, 741 
valueOf (String) 259 
values (HashMap ou TreeMap) 647 
variable 

interface 233 

locale 127 

non initialised 41 
Vector (classe) 627 
verrou 308 

visualisateur d' applets 532 
VK_ALT 463 
VK_ALT_GRAPH 463 
VK_CAPS_LOCK 464 
VK_CONTROL 464 
VK_DELETE 464 
VK_DOWN 464 
VK_END 464 
VK_ENTER 464 
VK_ESCAPE 464 
VK_HOME 464 
VKJNSERT 464 
VK_LEFT 464 
VK_NUM_LOCK 464 
VK_PAGE_DOWN 464 
VK_PAGE_UP 464 
VK_PRINTSCREEN 464 
VK_RIGHT 464 
VK_SCROLL_LOCK 464 
VK_SHIFT 464 
VK_SPACE 464 
VK_TAB 464 
vue 645, 687 

non modifiable 650 

synchronised 649 

w 

wait (Object) 310 
WARNING_MESSAGE 

(JOptionPane) 397 
web 531 

weightx (GridBagConstraints) 492 
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weighty (GridBagConstraints) 492 
WHEN_ANCESTOR_OF_FOCUS 

ED_COMPONENT 

(JComponent) 469 
WHEN_FOCUSED (JComponent) 

469 

WHEN_IN_FOCUSED_WINDO 

W (JComponent) 469 
while (instruction) 88 
width (Dimension) 356 
WIDTH (parametre) 530 
window Activated 

(WindowListener) 472, 741 
Window Adapter (classe) 472, 741 
windowClosed (WindowListener) 

472, 741 
windowClosing (WindowListener) 

472, 473, 741 
windowDeactivated 

(WindowListener) 472, 741 
windowDeiconified 

(WindowListener) 472, 741 
WindowEvent (classe) 472, 741, 

743 

windowlconified 
(WindowListener) 472, 741 



WindowListener (interface) 472, 
741 

windowOpened (WindowListener) 

472, 741 
write (OutputStream) 570 
write (Writer) 573 
WriteAbortedException 726 
writeBoolean (DataOutputStream) 

571 

writeBoolean (RandomAccesFile) 
573 

writeByte (DataOutputStream) 571 
writeByte (RandomAccesFile) 573 
writeChar (DataOutputStream) 57 1 
writeChar (RandomAccesFile) 573 
writeChars 571 

writeDouble (DataOutputStream) 
571 

writeDouble (RandomAccesFile) 
573 

writeFloat (DataOutputStream) 571 
writeFloat (RandomAccesFile) 573 
writelnt (DataOutputStream) 547, 
571 

writelnt (RandomAccesFile) 573 
writeLong (DataOutputStream) 571 



writeLong (RandomAccesFile) 573 
Writer (classe) 557, 573 
writeShort (DataOutputStream) 
571 

writeShort (RandomAccesFile) 573 
writeUTF 571 

X 

Xll n 

XOR (mode) 521 

Y 

YES_NO_CANCEL_OPTION 

(JOptionPane) 400 
YES_NO_OPTION (JOptionPane) 

400 

YES_OPTION (JOptionPane) 399, 

400 
yield 316 
yield (Thread) 314 
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